R Reference

plotly is free for unlimited public use

Sensitive data? Upgrade to a paid plan or trial plotly offline

R figure reference

plotly charts are described declaritively in the call signature of plotly::plot_ly, plotly::add_trace, and plotly::layout. Every aspect of a plotly chart (the colors, the grid-lines, the data, and so on) has a corresponding key in these call signatures. This page contains an extensive list of these attributes.

Plotly's graph description places attributes into two categories: traces (which describe a single series of data in a graph) and layout attributes that apply to the rest of the chart, like the title, xaxis, or annotations).

Here is a simple example of a plotly chart inlined with links to each attribute's reference section.

library(plotly)

p <- plot_ly(economics,
    type = "scatter",       # all "scatter" attributes: https://plot.ly/r/reference/#scatter
    x = date,               # more about scatter's "x": /r/reference/#scatter-x
    y = uempmed,            # more about scatter's "y": /r/reference/#scatter-y
    name = "unemployment",  # more about scatter's "name": /r/reference/#scatter-name
    marker = list(          # marker is a named list, valid keys: /r/reference/#scatter-marker
        color="rgb(16, 32, 77)"     # more about marker's "color" attribute: /r/reference/#scatter-marker-color
    ),
    filename="r-docs/basic-time-series")

p <- add_trace(p,                       # by default, traces are type "scatter"
    y = fitted((loess(uempmed ~ as.numeric(date)))),  # scatter's "y": /r/reference/#scatter-y
    line = list(                        # line is a named list, valid keys: /r/reference/#scatter-line
        color = "rgb(60, 60, 60)",      # line's "color": /r/reference/#scatter-line-color
        dash = "dashed"                 # line's "dash" property: /r/reference/#scatter-line-dash
    )
)

maxdf <- dplyr::filter(uempmed == max(uempmed))

p <- layout(p,              # all of layout's properties: /r/reference/#layout
    title = "unemployment", # layout's title: /r/reference/#layout-title
    xaxis = list(           # layout's xaxis is a named list. List of valid keys: /r/reference/#layout-xaxis
        title = "time",     # xaxis's title: /r/reference/#layout-xaxis-title
        showgrid = F        # xaxis's showgrid: /r/reference/#layout-xaxis-showgrid
    ),
    yaxis = list(           # layout's yaxis is a named list. List of valid keys: /r/reference/#layout-yaxis
        title = "uidx"      # yaxis's title: /r/reference/#layout-yaxis-title
    ),
    annotations = list(         # all annotation properties: /r/reference/#layout-annotations
        list(
            x = maxdf$date,     # annotation's x: /r/reference/#layout-annotations-x
            y = maxdf$uempmed,  # annotation's y: /r/reference/#layout-annotations-y
            text = "Peak",      # annotation's text: /r/reference/#layout-annotations-text
            showarrow = T       # annotation's showarrow: /r/reference/#layout-annotations-showarrow
        )
    )
)

scatter

A scatter trace is initialized with plot_ly or add_trace:

plot_ly(df, type="scatter"[, ...])

                      add_trace(p, type="scatter"[, ...])

A scatter trace accepts any of the keys listed below.

The data visualized as scatter point or lines is set in `x` and `y` Text (appearing either on the chart or on hover only) is via `text`. Bubble charts are achieved by setting `marker.size` and/or `marker.color` to a numerical arrays.

type ("scatter")
x (dataframe column, list, vector)
Sets the x coordinates.
x0 (any)
default: 0
Alternate to `x`. Builds a linear space of x coordinates. Use with `dx` where `x0` is the starting coordinate and `dx` the step.
dx (number)
default: 1
Sets the x coordinate step. See `x0` for more info.
y (dataframe column, list, vector)
Sets the y coordinates.
y0 (any)
default: 0
Alternate to `y`. Builds a linear space of y coordinates. Use with `dy` where `y0` is the starting coordinate and `dy` the step.
dy (number)
default: 1
Sets the y coordinate step. See `y0` for more info.
text (string)
default: ""
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates.
mode (flaglist)
flags: "lines" | "markers" | "text"
extras: "none"
examples: "lines", "markers", "lines+markers", "lines+markers+text", "none"
Determines the drawing mode for this scatter trace. If the provided `mode` includes "text" then the `text` elements appear at the coordinates. Otherwise, the `text` elements appear on hover.
line (named list)
- color (color)
  Sets the line color.
- width (number greater than or equal to 0)
  default: 2
  Sets the line width (in px).
- shape (enumerated: "linear" | "spline" | "hv" | "vh" | "hvh" | "vhv")
  default: "linear"
  Determines the line shape. With "spline" the lines are drawn using spline interpolation. The other available values correspond to step-wise line shapes.
- smoothing (number between or equal to 0 and 1.3)
  default: 1
  Has only an effect if `shape` is set to "spline" Sets the amount of smoothing. "0" corresponds to no smoothing (equivalent to a "linear" shape).
- dash (string)
  default: "solid"
  Sets the style of the lines.
connectgaps (boolean)
Determines whether or not gaps (i.e. {nan} or missing values) in the provided data arrays are connected.
fill (enumerated: "none" | "tozeroy" | "tozerox" | "tonexty" | "tonextx")
default: "none"
Sets the area to fill with a solid color. Use with `fillcolor`.
fillcolor (color)
Sets the fill color.
marker (named list)
- symbol (enumerated: "0" | "circle" | "100" | "circle-open" | "200" | "circle-dot" | "300" | "circle-open-dot" | "1" | "square" | "101" | "square-open" | "201" | "square-dot" | "301" | "square-open-dot" | "2" | "diamond" | "102" | "diamond-open" | "202" | "diamond-dot" | "302" | "diamond-open-dot" | "3" | "cross" | "103" | "cross-open" | "203" | "cross-dot" | "303" | "cross-open-dot" | "4" | "x" | "104" | "x-open" | "204" | "x-dot" | "304" | "x-open-dot" | "5" | "triangle-up" | "105" | "triangle-up-open" | "205" | "triangle-up-dot" | "305" | "triangle-up-open-dot" | "6" | "triangle-down" | "106" | "triangle-down-open" | "206" | "triangle-down-dot" | "306" | "triangle-down-open-dot" | "7" | "triangle-left" | "107" | "triangle-left-open" | "207" | "triangle-left-dot" | "307" | "triangle-left-open-dot" | "8" | "triangle-right" | "108" | "triangle-right-open" | "208" | "triangle-right-dot" | "308" | "triangle-right-open-dot" | "9" | "triangle-ne" | "109" | "triangle-ne-open" | "209" | "triangle-ne-dot" | "309" | "triangle-ne-open-dot" | "10" | "triangle-se" | "110" | "triangle-se-open" | "210" | "triangle-se-dot" | "310" | "triangle-se-open-dot" | "11" | "triangle-sw" | "111" | "triangle-sw-open" | "211" | "triangle-sw-dot" | "311" | "triangle-sw-open-dot" | "12" | "triangle-nw" | "112" | "triangle-nw-open" | "212" | "triangle-nw-dot" | "312" | "triangle-nw-open-dot" | "13" | "pentagon" | "113" | "pentagon-open" | "213" | "pentagon-dot" | "313" | "pentagon-open-dot" | "14" | "hexagon" | "114" | "hexagon-open" | "214" | "hexagon-dot" | "314" | "hexagon-open-dot" | "15" | "hexagon2" | "115" | "hexagon2-open" | "215" | "hexagon2-dot" | "315" | "hexagon2-open-dot" | "16" | "octagon" | "116" | "octagon-open" | "216" | "octagon-dot" | "316" | "octagon-open-dot" | "17" | "star" | "117" | "star-open" | "217" | "star-dot" | "317" | "star-open-dot" | "18" | "hexagram" | "118" | "hexagram-open" | "218" | "hexagram-dot" | "318" | "hexagram-open-dot" | "19" | "star-triangle-up" | "119" | "star-triangle-up-open" | "219" | "star-triangle-up-dot" | "319" | "star-triangle-up-open-dot" | "20" | "star-triangle-down" | "120" | "star-triangle-down-open" | "220" | "star-triangle-down-dot" | "320" | "star-triangle-down-open-dot" | "21" | "star-square" | "121" | "star-square-open" | "221" | "star-square-dot" | "321" | "star-square-open-dot" | "22" | "star-diamond" | "122" | "star-diamond-open" | "222" | "star-diamond-dot" | "322" | "star-diamond-open-dot" | "23" | "diamond-tall" | "123" | "diamond-tall-open" | "223" | "diamond-tall-dot" | "323" | "diamond-tall-open-dot" | "24" | "diamond-wide" | "124" | "diamond-wide-open" | "224" | "diamond-wide-dot" | "324" | "diamond-wide-open-dot" | "25" | "hourglass" | "125" | "hourglass-open" | "26" | "bowtie" | "126" | "bowtie-open" | "27" | "circle-cross" | "127" | "circle-cross-open" | "28" | "circle-x" | "128" | "circle-x-open" | "29" | "square-cross" | "129" | "square-cross-open" | "30" | "square-x" | "130" | "square-x-open" | "31" | "diamond-cross" | "131" | "diamond-cross-open" | "32" | "diamond-x" | "132" | "diamond-x-open" | "33" | "cross-thin" | "133" | "cross-thin-open" | "34" | "x-thin" | "134" | "x-thin-open" | "35" | "asterisk" | "135" | "asterisk-open" | "36" | "hash" | "136" | "hash-open" | "236" | "hash-dot" | "336" | "hash-open-dot" | "37" | "y-up" | "137" | "y-up-open" | "38" | "y-down" | "138" | "y-down-open" | "39" | "y-left" | "139" | "y-left-open" | "40" | "y-right" | "140" | "y-right-open" | "41" | "line-ew" | "141" | "line-ew-open" | "42" | "line-ns" | "142" | "line-ns-open" | "43" | "line-ne" | "143" | "line-ne-open" | "44" | "line-nw" | "144" | "line-nw-open")
  default: "circle"
  Sets the marker symbol type. Adding 100 is equivalent to appending "-open" to a symbol name. Adding 200 is equivalent to appending "-dot" to a symbol name. Adding 300 is equivalent to appending "-open-dot" or "dot-open" to a symbol name.
- opacity (number between or equal to 0 and 1)
  Sets the marker opacity.
- size (number greater than or equal to 0)
  default: 6
  Sets the marker size (in px).
- color (color)
  Sets the marker color.
- maxdisplayed (number greater than or equal to 0)
  default: 0
  Sets a maximum number of points to be drawn on the graph. "0" corresponds to no limit.
- sizeref (number)
  default: 1
  Has only an effect if `marker.size` is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with `sizemin` and `sizemode`.
- sizemin (number greater than or equal to 0)
  default: 0
  Has only an effect if `marker.size` is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
- sizemode (enumerated: "diameter" | "area")
  default: "diameter"
  Has only an effect if `marker.size` is set to a numerical array. Sets the rule for which the data in `size` is converted to pixels.
- colorscale (colorscale)
  Has only an effect if `marker.color` is set to a numerical array. Sets the colorscale.
- cauto (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines the whether or not the color domain is computed automatically.
- cmax (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the upper bound of the color domain.
- cmin (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the lower bound of the color domain.
- autocolorscale (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not the colorscale is picked using values inside `marker.color`.
- reversescale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Reverses the colorscale.
- showscale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not a colorbar is displayed.
- line (named list)
  - color (color)
    Sets the color of the lines bounding the marker points.
  - width (number greater than or equal to 0)
    Sets the width (in px) of the lines bounding the marker points.
  - colorscale (colorscale)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the colorscale.
  - cauto (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines the whether or not the color domain is computed with respect to the input data.
  - cmax (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the upper bound of the color domain.
  - cmin (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the lower bound of the color domain.
  - autocolorscale (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines whether or not the colorscale is picked using the sign of values inside `marker.line.color`.
  - reversescale (boolean)
    Has only an effect if `marker.color.line` is set to a numerical array. Reverses the colorscale.
  - colorsrc (string)
    Sets the source reference on plot.ly for color .
  - widthsrc (string)
    Sets the source reference on plot.ly for width .
- colorbar (named list)
  - thicknessmode (enumerated: "fraction" | "pixels")
    default: "pixels"
    Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
  - thickness (number greater than or equal to 0)
    default: 30
    Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
  - lenmode (enumerated: "fraction" | "pixels")
    default: "fraction"
    Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
  - len (number greater than or equal to 0)
    default: 1
    Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
  - x (number)
    default: 1.02
    Sets the x position of the color bar (in plot fraction).
  - xanchor (enumerated: "left" | "center" | "right")
    default: "left"
    Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
  - xpad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the x direction.
  - y (number)
    default: 0.5
    Sets the y position of the color bar (in plot fraction).
  - yanchor (enumerated: "top" | "middle" | "bottom")
    default: "middle"
    Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
  - ypad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the y direction.
  - outlinecolor (color)
    default: "#444"
    Sets the axis line color.
  - outlinewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - bordercolor (color)
    default: "#444"
    Sets the axis line color.
  - borderwidth (number greater than or equal to 0)
    default: 0
    Sets the width (in px) or the border enclosing this color bar.
  - bgcolor (color)
    default: "rgba(0,0,0,0)"
    Sets the color of padded area.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    default: ""
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - title (string)
    default: "Click to enter colorscale title"
    Sets the title of the color bar.
  - titlefont (named list)
    Sets this color bar's title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - titleside (enumerated: "right" | "top" | "bottom")
    default: "top"
    Determines the location of the colorbar title with respect to the color bar.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- symbolsrc (string)
  Sets the source reference on plot.ly for symbol .
- opacitysrc (string)
  Sets the source reference on plot.ly for opacity .
- sizesrc (string)
  Sets the source reference on plot.ly for size .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
textposition (enumerated: "top left" | "top center" | "top right" | "middle left" | "middle center" | "middle right" | "bottom left" | "bottom center" | "bottom right")
default: "middle center"
Sets the positions of the `text` elements with respects to the (x,y) coordinates.
textfont (named list)
Sets the text font.
- family (string)
- size (number greater than or equal to 1)
- color (color)
- familysrc (string)
  Sets the source reference on plot.ly for family .
- sizesrc (string)
  Sets the source reference on plot.ly for size .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
r (dataframe column, list, vector)
For polar chart only.Sets the radial coordinates.
t (dataframe column, list, vector)
For polar chart only.Sets the angular coordinates.
error_y (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
error_x (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .
textpositionsrc (string)
Sets the source reference on plot.ly for textposition .
rsrc (string)
Sets the source reference on plot.ly for r .
tsrc (string)
Sets the source reference on plot.ly for t .

bar

A bar trace is initialized with plot_ly or add_trace:

plot_ly(df, type="bar"[, ...])

                      add_trace(p, type="bar"[, ...])

A bar trace accepts any of the keys listed below.

The data visualized by the span of the bars is set in `y` if `orientation` is set th "v" (the default) and the labels are set in `x`. By setting `orientation` to "h", the roles are interchanged.

type ("bar")
x (dataframe column, list, vector)
Sets the x coordinates.
x0 (any)
default: 0
Alternate to `x`. Builds a linear space of x coordinates. Use with `dx` where `x0` is the starting coordinate and `dx` the step.
dx (number)
default: 1
Sets the x coordinate step. See `x0` for more info.
y (dataframe column, list, vector)
Sets the y coordinates.
y0 (any)
default: 0
Alternate to `y`. Builds a linear space of y coordinates. Use with `dy` where `y0` is the starting coordinate and `dy` the step.
dy (number)
default: 1
Sets the y coordinate step. See `y0` for more info.
text (string)
default: ""
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates.
orientation (enumerated: "v" | "h")
Sets the orientation of the bars. With "v" ("h"), the value of the each bar spans along the vertical (horizontal).
marker (named list)
- color (color)
  Sets the marker color.
- colorscale (colorscale)
  Has only an effect if `marker.color` is set to a numerical array. Sets the colorscale.
- cauto (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines the whether or not the color domain is computed automatically.
- cmax (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the upper bound of the color domain.
- cmin (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the lower bound of the color domain.
- autocolorscale (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not the colorscale is picked using values inside `marker.color`.
- reversescale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Reverses the colorscale.
- showscale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not a colorbar is displayed.
- line (named list)
  - color (color)
    Sets the color of the lines bounding the marker points.
  - colorscale (colorscale)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the colorscale.
  - cauto (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines the whether or not the color domain is computed with respect to the input data.
  - cmax (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the upper bound of the color domain.
  - cmin (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the lower bound of the color domain.
  - width (number greater than or equal to 0)
    Sets the width (in px) of the lines bounding the marker points.
  - autocolorscale (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines whether or not the colorscale is picked using the sign of values inside `marker.line.color`.
  - reversescale (boolean)
    Has only an effect if `marker.color.line` is set to a numerical array. Reverses the colorscale.
  - colorsrc (string)
    Sets the source reference on plot.ly for color .
  - widthsrc (string)
    Sets the source reference on plot.ly for width .
- colorbar (named list)
  - thicknessmode (enumerated: "fraction" | "pixels")
    default: "pixels"
    Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
  - thickness (number greater than or equal to 0)
    default: 30
    Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
  - lenmode (enumerated: "fraction" | "pixels")
    default: "fraction"
    Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
  - len (number greater than or equal to 0)
    default: 1
    Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
  - x (number)
    default: 1.02
    Sets the x position of the color bar (in plot fraction).
  - xanchor (enumerated: "left" | "center" | "right")
    default: "left"
    Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
  - xpad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the x direction.
  - y (number)
    default: 0.5
    Sets the y position of the color bar (in plot fraction).
  - yanchor (enumerated: "top" | "middle" | "bottom")
    default: "middle"
    Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
  - ypad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the y direction.
  - outlinecolor (color)
    default: "#444"
    Sets the axis line color.
  - outlinewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - bordercolor (color)
    default: "#444"
    Sets the axis line color.
  - borderwidth (number greater than or equal to 0)
    default: 0
    Sets the width (in px) or the border enclosing this color bar.
  - bgcolor (color)
    default: "rgba(0,0,0,0)"
    Sets the color of padded area.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    default: ""
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - title (string)
    default: "Click to enter colorscale title"
    Sets the title of the color bar.
  - titlefont (named list)
    Sets this color bar's title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - titleside (enumerated: "right" | "top" | "bottom")
    default: "top"
    Determines the location of the colorbar title with respect to the color bar.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
r (dataframe column, list, vector)
For polar chart only.Sets the radial coordinates.
t (dataframe column, list, vector)
For polar chart only.Sets the angular coordinates.
error_y (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
error_x (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
_deprecated
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .
rsrc (string)
Sets the source reference on plot.ly for r .
tsrc (string)
Sets the source reference on plot.ly for t .

box

A box trace is initialized with plot_ly or add_trace:

plot_ly(df, type="box"[, ...])

                      add_trace(p, type="box"[, ...])

A box trace accepts any of the keys listed below.

In vertical (horizontal) box plots, statistics are computed using `y` (`x`) values. By supplying an `x` (`y`) array, one box per distinct x (y) value is drawn If no `x` (`y`) list is provided, a single box is drawn. That box position is then positioned with with `name` or with `x0` (`y0`) if provided. Each box spans from quartile 1 (Q1) to quartile 3 (Q3). The second quartile (Q2) is marked by a line inside the box. By default, the whiskers correspond to the box' edges +/- 1.5 times the interquartile range (IQR = Q3-Q1), see "boxpoints" for other options.

type ("box")
y (dataframe column, list, vector)
Sets the y sample data or coordinates. See overview for more info.
x (dataframe column, list, vector)
Sets the x sample data or coordinates. See overview for more info.
x0 (any)
Sets the x coordinate of the box. See overview for more info.
y0 (any)
Sets the y coordinate of the box. See overview for more info.
whiskerwidth (number between or equal to 0 and 1)
default: 0.5
Sets the width of the whiskers relative to the box' width. For example, with 1, the whiskers are as wide as the box(es).
boxpoints (enumerated: "all" | "outliers" | "suspectedoutliers" | false)
default: "outliers"
If "outliers", only the sample points lying outside the whiskers are shown If "suspectedoutliers", the outlier points are shown and points either less than 4"Q1-3"Q3 or greater than 4"Q3-3"Q1 are highlighted (see `outliercolor`) If "all", all sample points are shown If "false", only the box(es) are shown with no sample points
boxmean (enumerated: true | "sd" | false)
If "true", the mean of the box(es)' underlying distribution is drawn as a dashed line inside the box(es). If "sd" the standard deviation is also drawn.
jitter (number between or equal to 0 and 1)
Sets the amount of jitter in the sample points drawn. If "0", the sample points align along the distribution axis. If "1", the sample points are drawn in a random jitter of width equal to the width of the box(es).
pointpos (number between or equal to -2 and 2)
Sets the position of the sample points in relation to the box(es). If "0", the sample points are places over the center of the box(es). Positive (negative) values correspond to positions to the right (left) for vertical boxes and above (below) for horizontal boxes
orientation (enumerated: "v" | "h")
Sets the orientation of the box(es). If "v" ("h"), the distribution is visualized along the vertical (horizontal).
marker (named list)
- outliercolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of the outlier sample points.
- symbol (enumerated: "0" | "circle" | "100" | "circle-open" | "200" | "circle-dot" | "300" | "circle-open-dot" | "1" | "square" | "101" | "square-open" | "201" | "square-dot" | "301" | "square-open-dot" | "2" | "diamond" | "102" | "diamond-open" | "202" | "diamond-dot" | "302" | "diamond-open-dot" | "3" | "cross" | "103" | "cross-open" | "203" | "cross-dot" | "303" | "cross-open-dot" | "4" | "x" | "104" | "x-open" | "204" | "x-dot" | "304" | "x-open-dot" | "5" | "triangle-up" | "105" | "triangle-up-open" | "205" | "triangle-up-dot" | "305" | "triangle-up-open-dot" | "6" | "triangle-down" | "106" | "triangle-down-open" | "206" | "triangle-down-dot" | "306" | "triangle-down-open-dot" | "7" | "triangle-left" | "107" | "triangle-left-open" | "207" | "triangle-left-dot" | "307" | "triangle-left-open-dot" | "8" | "triangle-right" | "108" | "triangle-right-open" | "208" | "triangle-right-dot" | "308" | "triangle-right-open-dot" | "9" | "triangle-ne" | "109" | "triangle-ne-open" | "209" | "triangle-ne-dot" | "309" | "triangle-ne-open-dot" | "10" | "triangle-se" | "110" | "triangle-se-open" | "210" | "triangle-se-dot" | "310" | "triangle-se-open-dot" | "11" | "triangle-sw" | "111" | "triangle-sw-open" | "211" | "triangle-sw-dot" | "311" | "triangle-sw-open-dot" | "12" | "triangle-nw" | "112" | "triangle-nw-open" | "212" | "triangle-nw-dot" | "312" | "triangle-nw-open-dot" | "13" | "pentagon" | "113" | "pentagon-open" | "213" | "pentagon-dot" | "313" | "pentagon-open-dot" | "14" | "hexagon" | "114" | "hexagon-open" | "214" | "hexagon-dot" | "314" | "hexagon-open-dot" | "15" | "hexagon2" | "115" | "hexagon2-open" | "215" | "hexagon2-dot" | "315" | "hexagon2-open-dot" | "16" | "octagon" | "116" | "octagon-open" | "216" | "octagon-dot" | "316" | "octagon-open-dot" | "17" | "star" | "117" | "star-open" | "217" | "star-dot" | "317" | "star-open-dot" | "18" | "hexagram" | "118" | "hexagram-open" | "218" | "hexagram-dot" | "318" | "hexagram-open-dot" | "19" | "star-triangle-up" | "119" | "star-triangle-up-open" | "219" | "star-triangle-up-dot" | "319" | "star-triangle-up-open-dot" | "20" | "star-triangle-down" | "120" | "star-triangle-down-open" | "220" | "star-triangle-down-dot" | "320" | "star-triangle-down-open-dot" | "21" | "star-square" | "121" | "star-square-open" | "221" | "star-square-dot" | "321" | "star-square-open-dot" | "22" | "star-diamond" | "122" | "star-diamond-open" | "222" | "star-diamond-dot" | "322" | "star-diamond-open-dot" | "23" | "diamond-tall" | "123" | "diamond-tall-open" | "223" | "diamond-tall-dot" | "323" | "diamond-tall-open-dot" | "24" | "diamond-wide" | "124" | "diamond-wide-open" | "224" | "diamond-wide-dot" | "324" | "diamond-wide-open-dot" | "25" | "hourglass" | "125" | "hourglass-open" | "26" | "bowtie" | "126" | "bowtie-open" | "27" | "circle-cross" | "127" | "circle-cross-open" | "28" | "circle-x" | "128" | "circle-x-open" | "29" | "square-cross" | "129" | "square-cross-open" | "30" | "square-x" | "130" | "square-x-open" | "31" | "diamond-cross" | "131" | "diamond-cross-open" | "32" | "diamond-x" | "132" | "diamond-x-open" | "33" | "cross-thin" | "133" | "cross-thin-open" | "34" | "x-thin" | "134" | "x-thin-open" | "35" | "asterisk" | "135" | "asterisk-open" | "36" | "hash" | "136" | "hash-open" | "236" | "hash-dot" | "336" | "hash-open-dot" | "37" | "y-up" | "137" | "y-up-open" | "38" | "y-down" | "138" | "y-down-open" | "39" | "y-left" | "139" | "y-left-open" | "40" | "y-right" | "140" | "y-right-open" | "41" | "line-ew" | "141" | "line-ew-open" | "42" | "line-ns" | "142" | "line-ns-open" | "43" | "line-ne" | "143" | "line-ne-open" | "44" | "line-nw" | "144" | "line-nw-open")
  default: "circle"
  Sets the marker symbol type. Adding 100 is equivalent to appending "-open" to a symbol name. Adding 200 is equivalent to appending "-dot" to a symbol name. Adding 300 is equivalent to appending "-open-dot" or "dot-open" to a symbol name.
- opacity (number between or equal to 0 and 1)
  default: 1
  Sets the marker opacity.
- size (number greater than or equal to 0)
  default: 6
  Sets the marker size (in px).
- color (color)
  Sets the marker color.
- line (named list)
  - color (color)
    default: "#444"
    Sets the color of the lines bounding the marker points.
  - width (number greater than or equal to 0)
    default: 0
    Sets the width (in px) of the lines bounding the marker points.
  - outliercolor (color)
    Sets the border line color of the outlier sample points.
  - outlierwidth (number greater than or equal to 0)
    default: 1
    Sets the border line width (in px) of the outlier sample points.
line (named list)
- color (color)
  Sets the color of line bounding the box(es).
- width (number greater than or equal to 0)
  default: 2
  Sets the width (in px) of line bounding the box(es).
fillcolor (color)
Sets the fill color.
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
ysrc (string)
Sets the source reference on plot.ly for y .
xsrc (string)
Sets the source reference on plot.ly for x .

heatmap

A heatmap trace is initialized with plot_ly or add_trace:

plot_ly(df, type="heatmap"[, ...])

                      add_trace(p, type="heatmap"[, ...])

A heatmap trace accepts any of the keys listed below.

The data that describes the heatmap value-to-color mapping is set in `z`. Data in `z` can either be a 2D list of values (ragged or not) or a 1D array of values. In the case where `z` is a 2D list, say that `z` has N rows and M columns. Then, by default, the resulting heatmap will have N partitions along the y axis and M partitions along the x axis. In other words, the i-th row/ j-th column cell in `z` is mapped to the i-th partition of the y axis (starting from the bottom of the plot) and the j-th partition of the x-axis (starting from the left of the plot). This behavior can be flipped by using `transpose`. Moreover, `x` (`y`) can be provided with M or M+1 (N or N+1) elements If M (N), then the coordinates correspond to the center of the heatmap cells and the cells have equal width. If M+1 (N+1), then the coordinates correspond to the edges of the heatmap cells. In the case where `z` is a 1D list, the x and y coordinates must be provided in `x` and `y` respectively to form data triplets.

type ("heatmap")
z (dataframe column, list, vector)
Sets the z data.
x (dataframe column, list, vector)
Sets the x coordinates.
x0 (any)
default: 0
Alternate to `x`. Builds a linear space of x coordinates. Use with `dx` where `x0` is the starting coordinate and `dx` the step.
dx (number)
default: 1
Sets the x coordinate step. See `x0` for more info.
y (dataframe column, list, vector)
Sets the y coordinates.
y0 (any)
default: 0
Alternate to `y`. Builds a linear space of y coordinates. Use with `dy` where `y0` is the starting coordinate and `dy` the step.
dy (number)
default: 1
Sets the y coordinate step. See `y0` for more info.
text (dataframe column, list, vector)
Sets the text elements associated with each z value.
transpose (boolean)
Transposes the z data.
xtype (enumerated: "array" | "scaled")
If "array", the heatmap's x coordinates are given by "x" (the default behavior when `x` is provided). If "scaled", the heatmap's x coordinates are given by "x0" and "dx" (the default behavior when `x` is not provided).
ytype (enumerated: "array" | "scaled")
If "array", the heatmap's y coordinates are given by "y" (the default behavior when `y` is provided) If "scaled", the heatmap's y coordinates are given by "y0" and "dy" (the default behavior when `y` is not provided)
zauto (boolean)
default: true
Determines the whether or not the color domain is computed with respect to the input data.
zmin (number)
Sets the lower bound of color domain.
zmax (number)
Sets the upper bound of color domain.
colorscale (colorscale)
Sets the colorscale.
autocolorscale (boolean)
Determines whether or not the colorscale is picked using the sign of the input z values.
reversescale (boolean)
Reverses the colorscale.
showscale (boolean)
default: true
Determines whether or not a colorbar is displayed for this trace.
zsmooth (enumerated: "fast" | "best" | false)
Picks a smoothing algorithm use to smooth `z` data.
connectgaps (boolean)
Determines whether or not gaps (i.e. {nan} or missing values) in the `z` data are filled in.
colorbar (named list)
- thicknessmode (enumerated: "fraction" | "pixels")
  default: "pixels"
  Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
- thickness (number greater than or equal to 0)
  default: 30
  Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- lenmode (enumerated: "fraction" | "pixels")
  default: "fraction"
  Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
- len (number greater than or equal to 0)
  default: 1
  Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- x (number)
  default: 1.02
  Sets the x position of the color bar (in plot fraction).
- xanchor (enumerated: "left" | "center" | "right")
  default: "left"
  Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
- xpad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the x direction.
- y (number)
  default: 0.5
  Sets the y position of the color bar (in plot fraction).
- yanchor (enumerated: "top" | "middle" | "bottom")
  default: "middle"
  Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
- ypad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the y direction.
- outlinecolor (color)
  default: "#444"
  Sets the axis line color.
- outlinewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- bordercolor (color)
  default: "#444"
  Sets the axis line color.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) or the border enclosing this color bar.
- bgcolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of padded area.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  default: ""
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- title (string)
  default: "Click to enter colorscale title"
  Sets the title of the color bar.
- titlefont (named list)
  Sets this color bar's title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- titleside (enumerated: "right" | "top" | "bottom")
  default: "top"
  Determines the location of the colorbar title with respect to the color bar.
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
zsrc (string)
Sets the source reference on plot.ly for z .
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .

histogram

A histogram trace is initialized with plot_ly or add_trace:

plot_ly(df, type="histogram"[, ...])

                      add_trace(p, type="histogram"[, ...])

A histogram trace accepts any of the keys listed below.

The sample data from which statistics are computed is set in `x` for vertically spanning histograms and in `y` for horizontally spanning histograms. Binning options are set `xbins` and `ybins` respectively if no aggregation data is provided.

type ("histogram")
x (dataframe column, list, vector)
Sets the sample data to be binned on the x axis.
x0 (any)
default: 0
Alternate to `x`. Builds a linear space of x coordinates. Use with `dx` where `x0` is the starting coordinate and `dx` the step.
dx (number)
default: 1
Sets the x coordinate step. See `x0` for more info.
y (dataframe column, list, vector)
Sets the sample data to be binned on the y axis.
y0 (any)
default: 0
Alternate to `y`. Builds a linear space of y coordinates. Use with `dy` where `y0` is the starting coordinate and `dy` the step.
dy (number)
default: 1
Sets the y coordinate step. See `y0` for more info.
text (string)
default: ""
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates.
orientation (enumerated: "v" | "h")
Sets the orientation of the bars. With "v" ("h"), the value of the each bar spans along the vertical (horizontal).
marker (named list)
- color (dataframe column, list, vector)
  Sets the marker color.
- colorscale (colorscale)
  Has only an effect if `marker.color` is set to a numerical array. Sets the colorscale.
- cauto (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines the whether or not the color domain is computed automatically.
- cmax (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the upper bound of the color domain.
- cmin (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the lower bound of the color domain.
- autocolorscale (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not the colorscale is picked using values inside `marker.color`.
- reversescale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Reverses the colorscale.
- showscale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not a colorbar is displayed.
- line (named list)
  - color (color)
    Sets the color of the lines bounding the marker points.
  - colorscale (colorscale)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the colorscale.
  - cauto (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines the whether or not the color domain is computed with respect to the input data.
  - cmax (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the upper bound of the color domain.
  - cmin (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the lower bound of the color domain.
  - width (number greater than or equal to 0)
    Sets the width (in px) of the lines bounding the marker points.
  - autocolorscale (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines whether or not the colorscale is picked using the sign of values inside `marker.line.color`.
  - reversescale (boolean)
    Has only an effect if `marker.color.line` is set to a numerical array. Reverses the colorscale.
  - colorsrc (string)
    Sets the source reference on plot.ly for color .
  - widthsrc (string)
    Sets the source reference on plot.ly for width .
- colorbar (named list)
  - thicknessmode (enumerated: "fraction" | "pixels")
    default: "pixels"
    Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
  - thickness (number greater than or equal to 0)
    default: 30
    Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
  - lenmode (enumerated: "fraction" | "pixels")
    default: "fraction"
    Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
  - len (number greater than or equal to 0)
    default: 1
    Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
  - x (number)
    default: 1.02
    Sets the x position of the color bar (in plot fraction).
  - xanchor (enumerated: "left" | "center" | "right")
    default: "left"
    Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
  - xpad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the x direction.
  - y (number)
    default: 0.5
    Sets the y position of the color bar (in plot fraction).
  - yanchor (enumerated: "top" | "middle" | "bottom")
    default: "middle"
    Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
  - ypad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the y direction.
  - outlinecolor (color)
    default: "#444"
    Sets the axis line color.
  - outlinewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - bordercolor (color)
    default: "#444"
    Sets the axis line color.
  - borderwidth (number greater than or equal to 0)
    default: 0
    Sets the width (in px) or the border enclosing this color bar.
  - bgcolor (color)
    default: "rgba(0,0,0,0)"
    Sets the color of padded area.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    default: ""
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - title (string)
    default: "Click to enter colorscale title"
    Sets the title of the color bar.
  - titlefont (named list)
    Sets this color bar's title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - titleside (enumerated: "right" | "top" | "bottom")
    default: "top"
    Determines the location of the colorbar title with respect to the color bar.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
r (dataframe column, list, vector)
For polar chart only.Sets the radial coordinates.
t (dataframe column, list, vector)
For polar chart only.Sets the angular coordinates.
z (dataframe column, list, vector)
Sets the aggregation data.
histfunc (enumerated: "count" | "sum" | "avg" | "min" | "max")
default: "count"
Specifies the binning function used for this histogram trace. If "count", the histogram values are computed by counting the number of values lying inside each bin. If "sum", "avg", "min", "max", the histogram values are computed using the sum, the average, the minimum or the maximum of the values lying inside each bin respectively.
histnorm (enumerated: "" | "percent" | "probability" | "density" | "probability density")
default: ""
Specifies the type of normalization used for this histogram trace. If "", the span of each bar corresponds to the number of occurrences (i.e. the number of data points lying inside the bins). If "percent", the span of each bar corresponds to the percentage of occurrences with respect to the total number of sample points (here, the sum of all bin area equals 100%). If "density", the span of each bar corresponds to the number of occurrences in a bin divided by the size of the bin interval (here, the sum of all bin area equals the total number of sample points). If "probability density", the span of each bar corresponds to the probability that an event will fall into the corresponding bin (here, the sum of all bin area equals 1).
autobinx (boolean)
default: true
Determines whether or not the x axis bin attributes are picked by an algorithm.
nbinsx (integer greater than or equal to 0)
default: 0
Sets the number of x axis bins.
xbins (named list)
- start (number)
  Sets the starting value for the x axis bins.
- end (number)
  Sets the end value for the x axis bins.
- size (any)
  default: 1
  Sets the step in-between value each x axis bin.
autobiny (boolean)
default: true
Determines whether or not the y axis bin attributes are picked by an algorithm.
nbinsy (integer greater than or equal to 0)
default: 0
Sets the number of y axis bins.
ybins (named list)
- start (number)
  Sets the starting value for the y axis bins.
- end (number)
  Sets the end value for the y axis bins.
- size (any)
  default: 1
  Sets the step in-between value each y axis bin.
error_y (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
error_x (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
_deprecated
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .
rsrc (string)
Sets the source reference on plot.ly for r .
tsrc (string)
Sets the source reference on plot.ly for t .
zsrc (string)
Sets the source reference on plot.ly for z .

histogram2d

A histogram2d trace is initialized with plot_ly or add_trace:

plot_ly(df, type="histogram2d"[, ...])

                      add_trace(p, type="histogram2d"[, ...])

A histogram2d trace accepts any of the keys listed below.

The sample data from which statistics are computed is set in `x` and `y` (where `x` and `y` represent marginal distributions, binning is set in `xbins` and `ybins` in this case) or `z` (where `z` represent the 2D distribution and binning set, binning is set by `x` and `y` in this case). The resulting distribution is visualized as a heatmap.

type ("histogram2d")
z (dataframe column, list, vector)
Sets the aggregation data.
x (dataframe column, list, vector)
Sets the sample data to be binned on the x axis.
x0 (any)
default: 0
Alternate to `x`. Builds a linear space of x coordinates. Use with `dx` where `x0` is the starting coordinate and `dx` the step.
dx (number)
default: 1
Sets the x coordinate step. See `x0` for more info.
y (dataframe column, list, vector)
Sets the sample data to be binned on the y axis.
y0 (any)
default: 0
Alternate to `y`. Builds a linear space of y coordinates. Use with `dy` where `y0` is the starting coordinate and `dy` the step.
dy (number)
default: 1
Sets the y coordinate step. See `y0` for more info.
text (dataframe column, list, vector)
Sets the text elements associated with each z value.
transpose (boolean)
Transposes the z data.
xtype (enumerated: "array" | "scaled")
If "array", the heatmap's x coordinates are given by "x" (the default behavior when `x` is provided). If "scaled", the heatmap's x coordinates are given by "x0" and "dx" (the default behavior when `x` is not provided).
ytype (enumerated: "array" | "scaled")
If "array", the heatmap's y coordinates are given by "y" (the default behavior when `y` is provided) If "scaled", the heatmap's y coordinates are given by "y0" and "dy" (the default behavior when `y` is not provided)
zauto (boolean)
default: true
Determines the whether or not the color domain is computed with respect to the input data.
zmin (number)
Sets the lower bound of color domain.
zmax (number)
Sets the upper bound of color domain.
colorscale (colorscale)
Sets the colorscale.
autocolorscale (boolean)
Determines whether or not the colorscale is picked using the sign of the input z values.
reversescale (boolean)
Reverses the colorscale.
showscale (boolean)
default: true
Determines whether or not a colorbar is displayed for this trace.
zsmooth (enumerated: "fast" | "best" | false)
Picks a smoothing algorithm use to smooth `z` data.
connectgaps (boolean)
Determines whether or not gaps (i.e. {nan} or missing values) in the `z` data are filled in.
colorbar (named list)
- thicknessmode (enumerated: "fraction" | "pixels")
  default: "pixels"
  Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
- thickness (number greater than or equal to 0)
  default: 30
  Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- lenmode (enumerated: "fraction" | "pixels")
  default: "fraction"
  Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
- len (number greater than or equal to 0)
  default: 1
  Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- x (number)
  default: 1.02
  Sets the x position of the color bar (in plot fraction).
- xanchor (enumerated: "left" | "center" | "right")
  default: "left"
  Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
- xpad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the x direction.
- y (number)
  default: 0.5
  Sets the y position of the color bar (in plot fraction).
- yanchor (enumerated: "top" | "middle" | "bottom")
  default: "middle"
  Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
- ypad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the y direction.
- outlinecolor (color)
  default: "#444"
  Sets the axis line color.
- outlinewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- bordercolor (color)
  default: "#444"
  Sets the axis line color.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) or the border enclosing this color bar.
- bgcolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of padded area.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  default: ""
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- title (string)
  default: "Click to enter colorscale title"
  Sets the title of the color bar.
- titlefont (named list)
  Sets this color bar's title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- titleside (enumerated: "right" | "top" | "bottom")
  default: "top"
  Determines the location of the colorbar title with respect to the color bar.
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
marker (named list)
- color (dataframe column, list, vector)
- colorsrc (string)
  Sets the source reference on plot.ly for color .
orientation (enumerated: "v" | "h")
Sets the orientation of the bars. With "v" ("h"), the value of the each bar spans along the vertical (horizontal).
histfunc (enumerated: "count" | "sum" | "avg" | "min" | "max")
default: "count"
Specifies the binning function used for this histogram trace. If "count", the histogram values are computed by counting the number of values lying inside each bin. If "sum", "avg", "min", "max", the histogram values are computed using the sum, the average, the minimum or the maximum of the values lying inside each bin respectively.
histnorm (enumerated: "" | "percent" | "probability" | "density" | "probability density")
default: ""
Specifies the type of normalization used for this histogram trace. If "", the span of each bar corresponds to the number of occurrences (i.e. the number of data points lying inside the bins). If "percent", the span of each bar corresponds to the percentage of occurrences with respect to the total number of sample points (here, the sum of all bin area equals 100%). If "density", the span of each bar corresponds to the number of occurrences in a bin divided by the size of the bin interval (here, the sum of all bin area equals the total number of sample points). If "probability density", the span of each bar corresponds to the probability that an event will fall into the corresponding bin (here, the sum of all bin area equals 1).
autobinx (boolean)
default: true
Determines whether or not the x axis bin attributes are picked by an algorithm.
nbinsx (integer greater than or equal to 0)
default: 0
Sets the number of x axis bins.
xbins (named list)
- start (number)
  Sets the starting value for the x axis bins.
- end (number)
  Sets the end value for the x axis bins.
- size (any)
  default: 1
  Sets the step in-between value each x axis bin.
autobiny (boolean)
default: true
Determines whether or not the y axis bin attributes are picked by an algorithm.
nbinsy (integer greater than or equal to 0)
default: 0
Sets the number of y axis bins.
ybins (named list)
- start (number)
  Sets the starting value for the y axis bins.
- end (number)
  Sets the end value for the y axis bins.
- size (any)
  default: 1
  Sets the step in-between value each y axis bin.
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
zsrc (string)
Sets the source reference on plot.ly for z .
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .

pie

A pie trace is initialized with plot_ly or add_trace:

plot_ly(df, type="pie"[, ...])

                      add_trace(p, type="pie"[, ...])

A pie trace accepts any of the keys listed below.

A data visualized by the sectors of the pie is set in `values`. The sector labels are set in `labels`. The sector colors are set in `marker.colors`

type ("pie")
labels (dataframe column, list, vector)
Sets the sector labels.
label0 (number)
default: 0
Alternate to `labels`. Builds a numeric set of labels. Use with `dlabel` where `label0` is the starting label and `dlabel` the step.
dlabel (number)
default: 1
Sets the label step. See `label0` for more info.
marker (named list)
- colors (dataframe column, list, vector)
  Sets the color of each sector of this pie chart. If not specified, the default trace color set is used to pick the sector colors.
- line (named list)
  - color (color)
    default: "#444"
    Sets the color of the line enclosing each sector.
  - width (number greater than or equal to 0)
    default: 0
    Sets the width (in px) of the line enclosing each sector.
  - colorsrc (string)
    Sets the source reference on plot.ly for color .
  - widthsrc (string)
    Sets the source reference on plot.ly for width .
- colorssrc (string)
  Sets the source reference on plot.ly for colors .
text (dataframe column, list, vector)
Sets text elements associated with each sector.
scalegroup (string)
default: ""
If there are multiple pies that should be sized according to their totals, link them by providing a non-empty group id here shared by every trace in the same group.
textinfo (flaglist)
flags: "label" | "text" | "value" | "percent"
extras: "none"
examples: "label", "text", "label+text", "label+text+value", "none"
Determines which trace information appear on the graph.
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
textposition (enumerated: "inside" | "outside" | "auto" | "none")
default: "auto"
Specifies the location of the `textinfo`.
textfont (named list)
Sets the font used for `textinfo`.
- family (string)
- size (number greater than or equal to 1)
- color (color)
insidetextfont (named list)
Sets the font used for `textinfo` lying inside the pie.
- family (string)
- size (number greater than or equal to 1)
- color (color)
outsidetextfont (named list)
Sets the font used for `textinfo` lying outside the pie.
- family (string)
- size (number greater than or equal to 1)
- color (color)
domain (named list)
- x (list)
  default: [0, 1]
  Sets the horizontal domain of this pie trace (in plot fraction).
- y (list)
  default: [0, 1]
  Sets the vertical domain of this pie trace (in plot fraction).
hole (number between or equal to 0 and 1)
default: 0
Sets the fraction of the radius to cut out of the pie. Use this to make a donut chart.
sort (boolean)
default: true
Determines whether or not the sectors of reordered from largest to smallest.
direction (enumerated: "clockwise" | "counterclockwise")
default: "counterclockwise"
Specifies the direction at which succeeding sectors follow one another.
rotation (number between or equal to -360 and 360)
default: 0
Instead of the first slice starting at 12 o'clock, rotate to some other angle.
pull (number between or equal to 0 and 1)
default: 0
Sets the fraction of larger radius to pull the sectors out from the center. This can be a constant to pull all slices apart from each other equally or an array to highlight one or more slices.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
labelssrc (string)
Sets the source reference on plot.ly for labels .
valuessrc (string)
Sets the source reference on plot.ly for values .
textsrc (string)
Sets the source reference on plot.ly for text .
textpositionsrc (string)
Sets the source reference on plot.ly for textposition .
pullsrc (string)
Sets the source reference on plot.ly for pull .

contour

A contour trace is initialized with plot_ly or add_trace:

plot_ly(df, type="contour"[, ...])

                      add_trace(p, type="contour"[, ...])

A contour trace accepts any of the keys listed below.

The data from which contour lines are computed is set in `z`. Data in `z` must be a 2D list of numbers. Say that `z` has N rows and M columns, then by default, these N rows correspond to N y coordinates (set in `y` or auto-generated) and the M columns correspond to M x coordinates (set in `x` or auto-generated). By setting `transpose` to "true", the above behavior is flipped.

type ("contour")
z (dataframe column, list, vector)
Sets the z data.
x (dataframe column, list, vector)
Sets the x coordinates.
x0 (any)
default: 0
Alternate to `x`. Builds a linear space of x coordinates. Use with `dx` where `x0` is the starting coordinate and `dx` the step.
dx (number)
default: 1
Sets the x coordinate step. See `x0` for more info.
y (dataframe column, list, vector)
Sets the y coordinates.
y0 (any)
default: 0
Alternate to `y`. Builds a linear space of y coordinates. Use with `dy` where `y0` is the starting coordinate and `dy` the step.
dy (number)
default: 1
Sets the y coordinate step. See `y0` for more info.
text (dataframe column, list, vector)
Sets the text elements associated with each z value.
transpose (boolean)
Transposes the z data.
xtype (enumerated: "array" | "scaled")
If "array", the heatmap's x coordinates are given by "x" (the default behavior when `x` is provided). If "scaled", the heatmap's x coordinates are given by "x0" and "dx" (the default behavior when `x` is not provided).
ytype (enumerated: "array" | "scaled")
If "array", the heatmap's y coordinates are given by "y" (the default behavior when `y` is provided) If "scaled", the heatmap's y coordinates are given by "y0" and "dy" (the default behavior when `y` is not provided)
zauto (boolean)
default: true
Determines the whether or not the color domain is computed with respect to the input data.
zmin (number)
Sets the lower bound of color domain.
zmax (number)
Sets the upper bound of color domain.
colorscale (colorscale)
Sets the colorscale.
autocolorscale (boolean)
Determines whether or not the colorscale is picked using the sign of the input z values.
reversescale (boolean)
Reverses the colorscale.
showscale (boolean)
default: true
Determines whether or not a colorbar is displayed for this trace.
zsmooth (enumerated: "fast" | "best" | false)
Picks a smoothing algorithm use to smooth `z` data.
connectgaps (boolean)
Determines whether or not gaps (i.e. {nan} or missing values) in the `z` data are filled in.
colorbar (named list)
- thicknessmode (enumerated: "fraction" | "pixels")
  default: "pixels"
  Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
- thickness (number greater than or equal to 0)
  default: 30
  Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- lenmode (enumerated: "fraction" | "pixels")
  default: "fraction"
  Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
- len (number greater than or equal to 0)
  default: 1
  Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- x (number)
  default: 1.02
  Sets the x position of the color bar (in plot fraction).
- xanchor (enumerated: "left" | "center" | "right")
  default: "left"
  Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
- xpad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the x direction.
- y (number)
  default: 0.5
  Sets the y position of the color bar (in plot fraction).
- yanchor (enumerated: "top" | "middle" | "bottom")
  default: "middle"
  Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
- ypad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the y direction.
- outlinecolor (color)
  default: "#444"
  Sets the axis line color.
- outlinewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- bordercolor (color)
  default: "#444"
  Sets the axis line color.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) or the border enclosing this color bar.
- bgcolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of padded area.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  default: ""
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- title (string)
  default: "Click to enter colorscale title"
  Sets the title of the color bar.
- titlefont (named list)
  Sets this color bar's title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- titleside (enumerated: "right" | "top" | "bottom")
  default: "top"
  Determines the location of the colorbar title with respect to the color bar.
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
autocontour (boolean)
default: true
Determines whether of not the contour level attributes at picked by an algorithm. If "true", the number of contour levels can be set in `ncontours`. If "false", set the contour level attributes in `contours`.
ncontours (integer)
default: 0
Sets the number of contour levels.
contours (named list)
- start (number)
  Sets the starting contour level value.
- end (number)
  Sets the end contour level value.
- size (number)
  Sets the step between each contour level.
- coloring (enumerated: "fill" | "heatmap" | "lines" | "none")
  default: "fill"
  Determines the coloring method showing the contour values. If "fill", coloring is done evenly between each contour level If "heatmap", a heatmap gradient is coloring is applied between each contour level. If "lines", coloring is done on the contour lines. If "none", no coloring is applied on this trace.
- showlines (boolean)
  default: true
  Determines whether or not the contour lines are drawn. Has only an effect if `contours.coloring` is set to "fill".
line (named list)
- color (color)
  Sets the color of the contour level. Has no if `contours.coloring` is set to "lines".
- width (number greater than or equal to 0)
  default: 2
  Sets the line width (in px).
- dash (string)
  default: "solid"
  Sets the style of the lines.
- smoothing (number between or equal to 0 and 1.3)
  default: 1
  Sets the amount of smoothing for the contour lines, where "0" corresponds to no smoothing.
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
zsrc (string)
Sets the source reference on plot.ly for z .
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .

histogram2dcontour

A histogram2dcontour trace is initialized with plot_ly or add_trace:

plot_ly(df, type="histogram2dcontour"[, ...])

                      add_trace(p, type="histogram2dcontour"[, ...])

A histogram2dcontour trace accepts any of the keys listed below.

The sample data from which statistics are computed is set in `x` and `y` (where `x` and `y` represent marginal distributions, binning is set in `xbins` and `ybins` in this case) or `z` (where `z` represent the 2D distribution and binning set, binning is set by `x` and `y` in this case). The resulting distribution is visualized as a contour plot.

type ("histogram2dcontour")
z (dataframe column, list, vector)
Sets the aggregation data.
x (dataframe column, list, vector)
Sets the sample data to be binned on the x axis.
x0 (any)
default: 0
Alternate to `x`. Builds a linear space of x coordinates. Use with `dx` where `x0` is the starting coordinate and `dx` the step.
dx (number)
default: 1
Sets the x coordinate step. See `x0` for more info.
y (dataframe column, list, vector)
Sets the sample data to be binned on the y axis.
y0 (any)
default: 0
Alternate to `y`. Builds a linear space of y coordinates. Use with `dy` where `y0` is the starting coordinate and `dy` the step.
dy (number)
default: 1
Sets the y coordinate step. See `y0` for more info.
text (dataframe column, list, vector)
Sets the text elements associated with each z value.
transpose (boolean)
Transposes the z data.
xtype (enumerated: "array" | "scaled")
If "array", the heatmap's x coordinates are given by "x" (the default behavior when `x` is provided). If "scaled", the heatmap's x coordinates are given by "x0" and "dx" (the default behavior when `x` is not provided).
ytype (enumerated: "array" | "scaled")
If "array", the heatmap's y coordinates are given by "y" (the default behavior when `y` is provided) If "scaled", the heatmap's y coordinates are given by "y0" and "dy" (the default behavior when `y` is not provided)
zauto (boolean)
default: true
Determines the whether or not the color domain is computed with respect to the input data.
zmin (number)
Sets the lower bound of color domain.
zmax (number)
Sets the upper bound of color domain.
colorscale (colorscale)
Sets the colorscale.
autocolorscale (boolean)
Determines whether or not the colorscale is picked using the sign of the input z values.
reversescale (boolean)
Reverses the colorscale.
showscale (boolean)
default: true
Determines whether or not a colorbar is displayed for this trace.
zsmooth (enumerated: "fast" | "best" | false)
Picks a smoothing algorithm use to smooth `z` data.
connectgaps (boolean)
Determines whether or not gaps (i.e. {nan} or missing values) in the `z` data are filled in.
colorbar (named list)
- thicknessmode (enumerated: "fraction" | "pixels")
  default: "pixels"
  Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
- thickness (number greater than or equal to 0)
  default: 30
  Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- lenmode (enumerated: "fraction" | "pixels")
  default: "fraction"
  Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
- len (number greater than or equal to 0)
  default: 1
  Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- x (number)
  default: 1.02
  Sets the x position of the color bar (in plot fraction).
- xanchor (enumerated: "left" | "center" | "right")
  default: "left"
  Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
- xpad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the x direction.
- y (number)
  default: 0.5
  Sets the y position of the color bar (in plot fraction).
- yanchor (enumerated: "top" | "middle" | "bottom")
  default: "middle"
  Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
- ypad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the y direction.
- outlinecolor (color)
  default: "#444"
  Sets the axis line color.
- outlinewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- bordercolor (color)
  default: "#444"
  Sets the axis line color.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) or the border enclosing this color bar.
- bgcolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of padded area.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  default: ""
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- title (string)
  default: "Click to enter colorscale title"
  Sets the title of the color bar.
- titlefont (named list)
  Sets this color bar's title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- titleside (enumerated: "right" | "top" | "bottom")
  default: "top"
  Determines the location of the colorbar title with respect to the color bar.
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
marker (named list)
- color (dataframe column, list, vector)
- colorsrc (string)
  Sets the source reference on plot.ly for color .
orientation (enumerated: "v" | "h")
Sets the orientation of the bars. With "v" ("h"), the value of the each bar spans along the vertical (horizontal).
histfunc (enumerated: "count" | "sum" | "avg" | "min" | "max")
default: "count"
Specifies the binning function used for this histogram trace. If "count", the histogram values are computed by counting the number of values lying inside each bin. If "sum", "avg", "min", "max", the histogram values are computed using the sum, the average, the minimum or the maximum of the values lying inside each bin respectively.
histnorm (enumerated: "" | "percent" | "probability" | "density" | "probability density")
default: ""
Specifies the type of normalization used for this histogram trace. If "", the span of each bar corresponds to the number of occurrences (i.e. the number of data points lying inside the bins). If "percent", the span of each bar corresponds to the percentage of occurrences with respect to the total number of sample points (here, the sum of all bin area equals 100%). If "density", the span of each bar corresponds to the number of occurrences in a bin divided by the size of the bin interval (here, the sum of all bin area equals the total number of sample points). If "probability density", the span of each bar corresponds to the probability that an event will fall into the corresponding bin (here, the sum of all bin area equals 1).
autobinx (boolean)
default: true
Determines whether or not the x axis bin attributes are picked by an algorithm.
nbinsx (integer greater than or equal to 0)
default: 0
Sets the number of x axis bins.
xbins (named list)
- start (number)
  Sets the starting value for the x axis bins.
- end (number)
  Sets the end value for the x axis bins.
- size (any)
  default: 1
  Sets the step in-between value each x axis bin.
autobiny (boolean)
default: true
Determines whether or not the y axis bin attributes are picked by an algorithm.
nbinsy (integer greater than or equal to 0)
default: 0
Sets the number of y axis bins.
ybins (named list)
- start (number)
  Sets the starting value for the y axis bins.
- end (number)
  Sets the end value for the y axis bins.
- size (any)
  default: 1
  Sets the step in-between value each y axis bin.
autocontour (boolean)
default: true
Determines whether of not the contour level attributes at picked by an algorithm. If "true", the number of contour levels can be set in `ncontours`. If "false", set the contour level attributes in `contours`.
ncontours (integer)
default: 0
Sets the number of contour levels.
contours (named list)
- start (number)
  Sets the starting contour level value.
- end (number)
  Sets the end contour level value.
- size (number)
  Sets the step between each contour level.
- coloring (enumerated: "fill" | "heatmap" | "lines" | "none")
  default: "fill"
  Determines the coloring method showing the contour values. If "fill", coloring is done evenly between each contour level If "heatmap", a heatmap gradient is coloring is applied between each contour level. If "lines", coloring is done on the contour lines. If "none", no coloring is applied on this trace.
- showlines (boolean)
  default: true
  Determines whether or not the contour lines are drawn. Has only an effect if `contours.coloring` is set to "fill".
line (named list)
- color (color)
  Sets the color of the contour level. Has no if `contours.coloring` is set to "lines".
- width (number greater than or equal to 0)
  default: 2
  Sets the line width (in px).
- dash (string)
  default: "solid"
  Sets the style of the lines.
- smoothing (number between or equal to 0 and 1.3)
  default: 1
  Sets the amount of smoothing for the contour lines, where "0" corresponds to no smoothing.
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
zsrc (string)
Sets the source reference on plot.ly for z .
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .

scatter3d

A scatter3d trace is initialized with plot_ly or add_trace:

plot_ly(df, type="scatter3d"[, ...])

                      add_trace(p, type="scatter3d"[, ...])

A scatter3d trace accepts any of the keys listed below.

The data visualized as scatter point or lines in 3D dimension is set in `x`, `y`, `z`. Text (appearing either on the chart or on hover only) is via `text`. Bubble charts are achieved by setting `marker.size` and/or `marker.color` Projections are achieved via `projection`. Surface fills are achieved via `surfaceaxis`.

type ("scatter3d")
x (dataframe column, list, vector)
Sets the x coordinates.
y (dataframe column, list, vector)
Sets the y coordinates.
z (dataframe column, list, vector)
Sets the z coordinates.
text (string)
default: ""
Sets text elements associated with each (x,y,z) triplet. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y,z) coordinates.
mode (flaglist)
flags: "lines" | "markers" | "text"
default: lines+markers
extras: "none"
examples: "lines", "markers", "lines+markers", "lines+markers+text", "none"
Determines the drawing mode for this scatter trace. If the provided `mode` includes "text" then the `text` elements appear at the coordinates. Otherwise, the `text` elements appear on hover.
surfaceaxis (enumerated: "-1" | "0" | "1" | "2")
default: "-1"
If "-1", the scatter points are not fill with a surface If "0", "1", "2", the scatter points are filled with a Delaunay surface about the x, y, z respectively.
surfacecolor (color)
Sets the surface fill color.
projection (named list)
- x (named list)
  - show (boolean)
    Sets whether or not projections are shown along the x axis.
  - opacity (number between or equal to 0 and 1)
    default: 1
    Sets the projection color.
  - scale (number between or equal to 0 and 10)
    default: 0.6666666666666666
    Sets the scale factor determining the size of the projection marker points.
- y (named list)
  - show (boolean)
    Sets whether or not projections are shown along the y axis.
  - opacity (number between or equal to 0 and 1)
    default: 1
    Sets the projection color.
  - scale (number between or equal to 0 and 10)
    default: 0.6666666666666666
    Sets the scale factor determining the size of the projection marker points.
- z (named list)
  - show (boolean)
    Sets whether or not projections are shown along the z axis.
  - opacity (number between or equal to 0 and 1)
    default: 1
    Sets the projection color.
  - scale (number between or equal to 0 and 10)
    default: 0.6666666666666666
    Sets the scale factor determining the size of the projection marker points.
line (named list)
- color (color)
  Sets the line color.
- width (number greater than or equal to 0)
  default: 2
  Sets the line width (in px).
- dash (string)
  default: "solid"
  Sets the style of the lines.
marker (named list)
- color (color)
  Sets the marker color.
- symbol (enumerated: "circle" | "circle-open" | "square" | "square-open" | "diamond" | "diamond-open" | "cross" | "x")
  default: "circle"
  Sets the marker symbol type.
- size (number greater than or equal to 0)
  default: 8
  Sets the marker size (in px).
- sizeref (number)
  default: 1
  Has only an effect if `marker.size` is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with `sizemin` and `sizemode`.
- sizemin (number greater than or equal to 0)
  default: 0
  Has only an effect if `marker.size` is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
- sizemode (enumerated: "diameter" | "area")
  default: "diameter"
  Has only an effect if `marker.size` is set to a numerical array. Sets the rule for which the data in `size` is converted to pixels.
- opacity (number between or equal to 0 and 1)
  Sets the marker opacity.
- colorscale (colorscale)
  Has only an effect if `marker.color` is set to a numerical array. Sets the colorscale.
- cauto (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines the whether or not the color domain is computed automatically.
- cmax (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the upper bound of the color domain.
- cmin (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the lower bound of the color domain.
- autocolorscale (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not the colorscale is picked using values inside `marker.color`.
- reversescale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Reverses the colorscale.
- showscale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not a colorbar is displayed.
- line (named list)
  - color (color)
    Sets the color of the lines bounding the marker points.
  - width (number greater than or equal to 0)
    Sets the width (in px) of the lines bounding the marker points.
  - colorscale (colorscale)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the colorscale.
  - cauto (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines the whether or not the color domain is computed with respect to the input data.
  - cmax (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the upper bound of the color domain.
  - cmin (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the lower bound of the color domain.
  - autocolorscale (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines whether or not the colorscale is picked using the sign of values inside `marker.line.color`.
  - reversescale (boolean)
    Has only an effect if `marker.color.line` is set to a numerical array. Reverses the colorscale.
  - colorsrc (string)
    Sets the source reference on plot.ly for color .
- colorbar (named list)
  - thicknessmode (enumerated: "fraction" | "pixels")
    default: "pixels"
    Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
  - thickness (number greater than or equal to 0)
    default: 30
    Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
  - lenmode (enumerated: "fraction" | "pixels")
    default: "fraction"
    Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
  - len (number greater than or equal to 0)
    default: 1
    Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
  - x (number)
    default: 1.02
    Sets the x position of the color bar (in plot fraction).
  - xanchor (enumerated: "left" | "center" | "right")
    default: "left"
    Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
  - xpad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the x direction.
  - y (number)
    default: 0.5
    Sets the y position of the color bar (in plot fraction).
  - yanchor (enumerated: "top" | "middle" | "bottom")
    default: "middle"
    Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
  - ypad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the y direction.
  - outlinecolor (color)
    default: "#444"
    Sets the axis line color.
  - outlinewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - bordercolor (color)
    default: "#444"
    Sets the axis line color.
  - borderwidth (number greater than or equal to 0)
    default: 0
    Sets the width (in px) or the border enclosing this color bar.
  - bgcolor (color)
    default: "rgba(0,0,0,0)"
    Sets the color of padded area.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    default: ""
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - title (string)
    default: "Click to enter colorscale title"
    Sets the title of the color bar.
  - titlefont (named list)
    Sets this color bar's title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - titleside (enumerated: "right" | "top" | "bottom")
    default: "top"
    Determines the location of the colorbar title with respect to the color bar.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
- symbolsrc (string)
  Sets the source reference on plot.ly for symbol .
- sizesrc (string)
  Sets the source reference on plot.ly for size .
- opacitysrc (string)
  Sets the source reference on plot.ly for opacity .
textposition (enumerated: "top left" | "top center" | "top right" | "middle left" | "middle center" | "middle right" | "bottom left" | "bottom center" | "bottom right")
default: "top center"
Sets the positions of the `text` elements with respects to the (x,y) coordinates.
textfont (named list)
Sets the text font.
- family (string)
- size (number greater than or equal to 1)
- color (color)
- familysrc (string)
  Sets the source reference on plot.ly for family .
- sizesrc (string)
  Sets the source reference on plot.ly for size .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
error_x (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
error_y (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
error_z (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
scene (sceneid)
default: scene
Sets a reference between this trace's 3D coordinate system and a 3D scene. If "scene" (the default value), the (x,y,z) coordinates refer to `layout.scene`. If "scene2", the (x,y,z) coordinates refer to `layout.scene2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
zsrc (string)
Sets the source reference on plot.ly for z .
textsrc (string)
Sets the source reference on plot.ly for text .
textpositionsrc (string)
Sets the source reference on plot.ly for textposition .

surface

A surface trace is initialized with plot_ly or add_trace:

plot_ly(df, type="surface"[, ...])

                      add_trace(p, type="surface"[, ...])

A surface trace accepts any of the keys listed below.

The data the describes the coordinates of the surface is set in `z`. Data in `z` should be a 2D list. Coordinates in `x` and `y` can either be 1D lists or {2D arrays} (e.g. to graph parametric surfaces). If not provided in `x` and `y`, the x and y coordinates are assumed to be linear starting at 0 with a unit step.

type ("surface")
z (dataframe column, list, vector)
Sets the z coordinates.
x (dataframe column, list, vector)
Sets the x coordinates.
y (dataframe column, list, vector)
Sets the y coordinates.
text (dataframe column, list, vector)
Sets the text elements associated with each z value.
zauto (boolean)
default: true
Determines the whether or not the color domain is computed with respect to the input data.
zmin (number)
Sets the lower bound of color domain.
zmax (number)
Sets the upper bound of color domain.
colorscale (colorscale)
Sets the colorscale.
autocolorscale (boolean)
Determines whether or not the colorscale is picked using the sign of the input z values.
reversescale (boolean)
Reverses the colorscale.
showscale (boolean)
default: true
Determines whether or not a colorbar is displayed for this trace.
contours (named list)
- x (named list)
  - show (boolean)
    Sets whether or not dynamic contours are shown along the x axis
  - project (named list)
    - x (boolean)
      Sets whether or not the dynamic contours are projected along the x axis.
    - y (boolean)
      Sets whether or not the dynamic contours are projected along the y axis.
    - z (boolean)
      Sets whether or not the dynamic contours are projected along the z axis.
  - color (color)
    default: "#000"
  - usecolormap (boolean)
  - width (number between or equal to 1 and 16)
    default: 2
  - highlight (boolean)
  - highlightColor (color)
    default: "#000"
  - highlightWidth (number between or equal to 1 and 16)
    default: 2
- y (named list)
  - show (boolean)
    Sets whether or not dynamic contours are shown along the y axis
  - project (named list)
    - x (boolean)
      Sets whether or not the dynamic contours are projected along the x axis.
    - y (boolean)
      Sets whether or not the dynamic contours are projected along the y axis.
    - z (boolean)
      Sets whether or not the dynamic contours are projected along the z axis.
  - color (color)
    default: "#000"
  - usecolormap (boolean)
  - width (number between or equal to 1 and 16)
    default: 2
  - highlight (boolean)
  - highlightColor (color)
    default: "#000"
  - highlightWidth (number between or equal to 1 and 16)
    default: 2
- z (named list)
  - show (boolean)
    Sets whether or not dynamic contours are shown along the z axis
  - project (named list)
    - x (boolean)
      Sets whether or not the dynamic contours are projected along the x axis.
    - y (boolean)
      Sets whether or not the dynamic contours are projected along the y axis.
    - z (boolean)
      Sets whether or not the dynamic contours are projected along the z axis.
  - color (color)
    default: "#000"
  - usecolormap (boolean)
  - width (number between or equal to 1 and 16)
    default: 2
  - highlight (boolean)
  - highlightColor (color)
    default: "#000"
  - highlightWidth (number between or equal to 1 and 16)
    default: 2
hidesurface (boolean)
lighting (named list)
- ambient (number between or equal to 0 and 1)
  default: 0.8
- diffuse (number between or equal to 0 and 1)
  default: 0.8
- specular (number between or equal to 0 and 2)
  default: 0.05
- roughness (number between or equal to 0 and 1)
  default: 0.5
- fresnel (number between or equal to 0 and 5)
  default: 0.2
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
colorbar (named list)
- thicknessmode (enumerated: "fraction" | "pixels")
  default: "pixels"
  Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
- thickness (number greater than or equal to 0)
  default: 30
  Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- lenmode (enumerated: "fraction" | "pixels")
  default: "fraction"
  Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
- len (number greater than or equal to 0)
  default: 1
  Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- x (number)
  default: 1.02
  Sets the x position of the color bar (in plot fraction).
- xanchor (enumerated: "left" | "center" | "right")
  default: "left"
  Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
- xpad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the x direction.
- y (number)
  default: 0.5
  Sets the y position of the color bar (in plot fraction).
- yanchor (enumerated: "top" | "middle" | "bottom")
  default: "middle"
  Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
- ypad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the y direction.
- outlinecolor (color)
  default: "#444"
  Sets the axis line color.
- outlinewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- bordercolor (color)
  default: "#444"
  Sets the axis line color.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) or the border enclosing this color bar.
- bgcolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of padded area.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  default: ""
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- title (string)
  default: "Click to enter colorscale title"
  Sets the title of the color bar.
- titlefont (named list)
  Sets this color bar's title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- titleside (enumerated: "right" | "top" | "bottom")
  default: "top"
  Determines the location of the colorbar title with respect to the color bar.
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
scene (sceneid)
default: scene
Sets a reference between this trace's 3D coordinate system and a 3D scene. If "scene" (the default value), the (x,y,z) coordinates refer to `layout.scene`. If "scene2", the (x,y,z) coordinates refer to `layout.scene2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
zsrc (string)
Sets the source reference on plot.ly for z .
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .

mesh3d

A mesh3d trace is initialized with plot_ly or add_trace:

plot_ly(df, type="mesh3d"[, ...])

                      add_trace(p, type="mesh3d"[, ...])

A mesh3d trace accepts any of the keys listed below.

type ("mesh3d")
x (dataframe column, list, vector)
y (dataframe column, list, vector)
z (dataframe column, list, vector)
i (dataframe column, list, vector)
j (dataframe column, list, vector)
k (dataframe column, list, vector)
delaunayaxis (enumerated: "x" | "y" | "z")
default: "z"
alphahull (number)
default: -1
intensity (dataframe column, list, vector)
color (color)
vertexcolor (dataframe column, list, vector)
facecolor (dataframe column, list, vector)
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
flatshading (boolean)
contour (named list)
- show (boolean)
- color (color)
  default: "#000"
- width (number between or equal to 1 and 16)
  default: 2
colorscale (colorscale)
Sets the colorscale.
reversescale (boolean)
Reverses the colorscale.
showscale (boolean)
default: true
Determines whether or not a colorbar is displayed for this trace.
lighting (named list)
- ambient (number between or equal to 0 and 1)
  default: 0.8
- diffuse (number between or equal to 0 and 1)
  default: 0.8
- specular (number between or equal to 0 and 2)
  default: 0.05
- roughness (number between or equal to 0 and 1)
  default: 0.5
- fresnel (number between or equal to 0 and 5)
  default: 0.2
colorbar (named list)
- thicknessmode (enumerated: "fraction" | "pixels")
  default: "pixels"
  Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
- thickness (number greater than or equal to 0)
  default: 30
  Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- lenmode (enumerated: "fraction" | "pixels")
  default: "fraction"
  Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
- len (number greater than or equal to 0)
  default: 1
  Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- x (number)
  default: 1.02
  Sets the x position of the color bar (in plot fraction).
- xanchor (enumerated: "left" | "center" | "right")
  default: "left"
  Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
- xpad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the x direction.
- y (number)
  default: 0.5
  Sets the y position of the color bar (in plot fraction).
- yanchor (enumerated: "top" | "middle" | "bottom")
  default: "middle"
  Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
- ypad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the y direction.
- outlinecolor (color)
  default: "#444"
  Sets the axis line color.
- outlinewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- bordercolor (color)
  default: "#444"
  Sets the axis line color.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) or the border enclosing this color bar.
- bgcolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of padded area.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  default: ""
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- title (string)
  default: "Click to enter colorscale title"
  Sets the title of the color bar.
- titlefont (named list)
  Sets this color bar's title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- titleside (enumerated: "right" | "top" | "bottom")
  default: "top"
  Determines the location of the colorbar title with respect to the color bar.
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
scene (sceneid)
default: scene
Sets a reference between this trace's 3D coordinate system and a 3D scene. If "scene" (the default value), the (x,y,z) coordinates refer to `layout.scene`. If "scene2", the (x,y,z) coordinates refer to `layout.scene2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
zsrc (string)
Sets the source reference on plot.ly for z .
isrc (string)
Sets the source reference on plot.ly for i .
jsrc (string)
Sets the source reference on plot.ly for j .
ksrc (string)
Sets the source reference on plot.ly for k .
intensitysrc (string)
Sets the source reference on plot.ly for intensity .
vertexcolorsrc (string)
Sets the source reference on plot.ly for vertexcolor .
facecolorsrc (string)
Sets the source reference on plot.ly for facecolor .

scattergeo

A scattergeo trace is initialized with plot_ly or add_trace:

plot_ly(df, type="scattergeo"[, ...])

                      add_trace(p, type="scattergeo"[, ...])

A scattergeo trace accepts any of the keys listed below.

The data visualized as scatter point or lines on a geographic map is provided either by longitude/latitude pairs in `lon` and `lat` respectively or by geographic location IDs or names in `locations`.

type ("scattergeo")
lon (dataframe column, list, vector)
Sets the longitude coordinates (in degrees East).
lat (dataframe column, list, vector)
Sets the latitude coordinates (in degrees North).
locations (dataframe column, list, vector)
Sets the coordinates via location IDs or names. Coordinates correspond to the centroid of each location given. See `locationmode` for more info.
locationmode (enumerated: "ISO-3" | "USA-states" | "country names")
default: "ISO-3"
Determines the set of locations used to match entries in `locations` to regions on the map.
mode (flaglist)
flags: "lines" | "markers" | "text"
default: markers
extras: "none"
examples: "lines", "markers", "lines+markers", "lines+markers+text", "none"
Determines the drawing mode for this scatter trace. If the provided `mode` includes "text" then the `text` elements appear at the coordinates. Otherwise, the `text` elements appear on hover.
text (string)
default: ""
Sets text elements associated with each (lon,lat) pair. or item in `locations`. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (lon,lat) or `locations` coordinates.
line (named list)
- color (color)
  Sets the line color.
- width (number greater than or equal to 0)
  default: 2
  Sets the line width (in px).
- dash (string)
  default: "solid"
  Sets the style of the lines.
marker (named list)
- symbol (enumerated: "0" | "circle" | "100" | "circle-open" | "200" | "circle-dot" | "300" | "circle-open-dot" | "1" | "square" | "101" | "square-open" | "201" | "square-dot" | "301" | "square-open-dot" | "2" | "diamond" | "102" | "diamond-open" | "202" | "diamond-dot" | "302" | "diamond-open-dot" | "3" | "cross" | "103" | "cross-open" | "203" | "cross-dot" | "303" | "cross-open-dot" | "4" | "x" | "104" | "x-open" | "204" | "x-dot" | "304" | "x-open-dot" | "5" | "triangle-up" | "105" | "triangle-up-open" | "205" | "triangle-up-dot" | "305" | "triangle-up-open-dot" | "6" | "triangle-down" | "106" | "triangle-down-open" | "206" | "triangle-down-dot" | "306" | "triangle-down-open-dot" | "7" | "triangle-left" | "107" | "triangle-left-open" | "207" | "triangle-left-dot" | "307" | "triangle-left-open-dot" | "8" | "triangle-right" | "108" | "triangle-right-open" | "208" | "triangle-right-dot" | "308" | "triangle-right-open-dot" | "9" | "triangle-ne" | "109" | "triangle-ne-open" | "209" | "triangle-ne-dot" | "309" | "triangle-ne-open-dot" | "10" | "triangle-se" | "110" | "triangle-se-open" | "210" | "triangle-se-dot" | "310" | "triangle-se-open-dot" | "11" | "triangle-sw" | "111" | "triangle-sw-open" | "211" | "triangle-sw-dot" | "311" | "triangle-sw-open-dot" | "12" | "triangle-nw" | "112" | "triangle-nw-open" | "212" | "triangle-nw-dot" | "312" | "triangle-nw-open-dot" | "13" | "pentagon" | "113" | "pentagon-open" | "213" | "pentagon-dot" | "313" | "pentagon-open-dot" | "14" | "hexagon" | "114" | "hexagon-open" | "214" | "hexagon-dot" | "314" | "hexagon-open-dot" | "15" | "hexagon2" | "115" | "hexagon2-open" | "215" | "hexagon2-dot" | "315" | "hexagon2-open-dot" | "16" | "octagon" | "116" | "octagon-open" | "216" | "octagon-dot" | "316" | "octagon-open-dot" | "17" | "star" | "117" | "star-open" | "217" | "star-dot" | "317" | "star-open-dot" | "18" | "hexagram" | "118" | "hexagram-open" | "218" | "hexagram-dot" | "318" | "hexagram-open-dot" | "19" | "star-triangle-up" | "119" | "star-triangle-up-open" | "219" | "star-triangle-up-dot" | "319" | "star-triangle-up-open-dot" | "20" | "star-triangle-down" | "120" | "star-triangle-down-open" | "220" | "star-triangle-down-dot" | "320" | "star-triangle-down-open-dot" | "21" | "star-square" | "121" | "star-square-open" | "221" | "star-square-dot" | "321" | "star-square-open-dot" | "22" | "star-diamond" | "122" | "star-diamond-open" | "222" | "star-diamond-dot" | "322" | "star-diamond-open-dot" | "23" | "diamond-tall" | "123" | "diamond-tall-open" | "223" | "diamond-tall-dot" | "323" | "diamond-tall-open-dot" | "24" | "diamond-wide" | "124" | "diamond-wide-open" | "224" | "diamond-wide-dot" | "324" | "diamond-wide-open-dot" | "25" | "hourglass" | "125" | "hourglass-open" | "26" | "bowtie" | "126" | "bowtie-open" | "27" | "circle-cross" | "127" | "circle-cross-open" | "28" | "circle-x" | "128" | "circle-x-open" | "29" | "square-cross" | "129" | "square-cross-open" | "30" | "square-x" | "130" | "square-x-open" | "31" | "diamond-cross" | "131" | "diamond-cross-open" | "32" | "diamond-x" | "132" | "diamond-x-open" | "33" | "cross-thin" | "133" | "cross-thin-open" | "34" | "x-thin" | "134" | "x-thin-open" | "35" | "asterisk" | "135" | "asterisk-open" | "36" | "hash" | "136" | "hash-open" | "236" | "hash-dot" | "336" | "hash-open-dot" | "37" | "y-up" | "137" | "y-up-open" | "38" | "y-down" | "138" | "y-down-open" | "39" | "y-left" | "139" | "y-left-open" | "40" | "y-right" | "140" | "y-right-open" | "41" | "line-ew" | "141" | "line-ew-open" | "42" | "line-ns" | "142" | "line-ns-open" | "43" | "line-ne" | "143" | "line-ne-open" | "44" | "line-nw" | "144" | "line-nw-open")
  default: "circle"
  Sets the marker symbol type. Adding 100 is equivalent to appending "-open" to a symbol name. Adding 200 is equivalent to appending "-dot" to a symbol name. Adding 300 is equivalent to appending "-open-dot" or "dot-open" to a symbol name.
- opacity (number between or equal to 0 and 1)
  Sets the marker opacity.
- size (number greater than or equal to 0)
  default: 6
  Sets the marker size (in px).
- sizeref (number)
  default: 1
  Has only an effect if `marker.size` is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with `sizemin` and `sizemode`.
- sizemin (number greater than or equal to 0)
  default: 0
  Has only an effect if `marker.size` is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
- sizemode (enumerated: "diameter" | "area")
  default: "diameter"
  Has only an effect if `marker.size` is set to a numerical array. Sets the rule for which the data in `size` is converted to pixels.
- color (color)
  Sets the marker color.
- colorscale (colorscale)
  Has only an effect if `marker.color` is set to a numerical array. Sets the colorscale.
- cauto (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines the whether or not the color domain is computed automatically.
- cmax (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the upper bound of the color domain.
- cmin (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the lower bound of the color domain.
- autocolorscale (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not the colorscale is picked using values inside `marker.color`.
- reversescale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Reverses the colorscale.
- showscale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not a colorbar is displayed.
- line (named list)
  - color (color)
    Sets the color of the lines bounding the marker points.
  - width (number greater than or equal to 0)
    Sets the width (in px) of the lines bounding the marker points.
  - colorscale (colorscale)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the colorscale.
  - cauto (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines the whether or not the color domain is computed with respect to the input data.
  - cmax (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the upper bound of the color domain.
  - cmin (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the lower bound of the color domain.
  - autocolorscale (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines whether or not the colorscale is picked using the sign of values inside `marker.line.color`.
  - reversescale (boolean)
    Has only an effect if `marker.color.line` is set to a numerical array. Reverses the colorscale.
  - colorsrc (string)
    Sets the source reference on plot.ly for color .
  - widthsrc (string)
    Sets the source reference on plot.ly for width .
- colorbar (named list)
  - thicknessmode (enumerated: "fraction" | "pixels")
    default: "pixels"
    Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
  - thickness (number greater than or equal to 0)
    default: 30
    Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
  - lenmode (enumerated: "fraction" | "pixels")
    default: "fraction"
    Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
  - len (number greater than or equal to 0)
    default: 1
    Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
  - x (number)
    default: 1.02
    Sets the x position of the color bar (in plot fraction).
  - xanchor (enumerated: "left" | "center" | "right")
    default: "left"
    Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
  - xpad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the x direction.
  - y (number)
    default: 0.5
    Sets the y position of the color bar (in plot fraction).
  - yanchor (enumerated: "top" | "middle" | "bottom")
    default: "middle"
    Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
  - ypad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the y direction.
  - outlinecolor (color)
    default: "#444"
    Sets the axis line color.
  - outlinewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - bordercolor (color)
    default: "#444"
    Sets the axis line color.
  - borderwidth (number greater than or equal to 0)
    default: 0
    Sets the width (in px) or the border enclosing this color bar.
  - bgcolor (color)
    default: "rgba(0,0,0,0)"
    Sets the color of padded area.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    default: ""
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - title (string)
    default: "Click to enter colorscale title"
    Sets the title of the color bar.
  - titlefont (named list)
    Sets this color bar's title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - titleside (enumerated: "right" | "top" | "bottom")
    default: "top"
    Determines the location of the colorbar title with respect to the color bar.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- symbolsrc (string)
  Sets the source reference on plot.ly for symbol .
- opacitysrc (string)
  Sets the source reference on plot.ly for opacity .
- sizesrc (string)
  Sets the source reference on plot.ly for size .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
textfont (named list)
Sets the text font.
- family (string)
- size (number greater than or equal to 1)
- color (color)
- familysrc (string)
  Sets the source reference on plot.ly for family .
- sizesrc (string)
  Sets the source reference on plot.ly for size .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
textposition (enumerated: "top left" | "top center" | "top right" | "middle left" | "middle center" | "middle right" | "bottom left" | "bottom center" | "bottom right")
default: "middle center"
Sets the positions of the `text` elements with respects to the (x,y) coordinates.
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
geo (geoid)
default: geo
Sets a reference between this trace's geospatial coordinates and a geographic map. If "geo" (the default value), the geospatial coordinates refer to `layout.geo`. If "geo2", the geospatial coordinates refer to `layout.geo2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
lonsrc (string)
Sets the source reference on plot.ly for lon .
latsrc (string)
Sets the source reference on plot.ly for lat .
locationssrc (string)
Sets the source reference on plot.ly for locations .
textsrc (string)
Sets the source reference on plot.ly for text .
textpositionsrc (string)
Sets the source reference on plot.ly for textposition .

choropleth

A choropleth trace is initialized with plot_ly or add_trace:

plot_ly(df, type="choropleth"[, ...])

                      add_trace(p, type="choropleth"[, ...])

A choropleth trace accepts any of the keys listed below.

The data that describes the choropleth value-to-color mapping is set in `z`. The geographic locations corresponding to each value in `z` are set in `locations`.

type ("choropleth")
locations (dataframe column, list, vector)
Sets the coordinates via location IDs or names. See `locationmode` for more info.
locationmode (enumerated: "ISO-3" | "USA-states" | "country names")
default: "ISO-3"
Determines the set of locations used to match entries in `locations` to regions on the map.
z (dataframe column, list, vector)
Sets the color values.
text (dataframe column, list, vector)
Sets the text elements associated with each location.
marker (named list)
- line (named list)
  - color (color)
    Sets the color of the lines bounding the marker points.
  - width (number greater than or equal to 0)
    Sets the width (in px) of the lines bounding the marker points.
  - colorsrc (string)
    Sets the source reference on plot.ly for color .
  - widthsrc (string)
    Sets the source reference on plot.ly for width .
zauto (boolean)
default: true
Determines the whether or not the color domain is computed with respect to the input data.
zmin (number)
Sets the lower bound of color domain.
zmax (number)
Sets the upper bound of color domain.
colorscale (colorscale)
Sets the colorscale.
autocolorscale (boolean)
default: true
Determines whether or not the colorscale is picked using the sign of the input z values.
reversescale (boolean)
Reverses the colorscale.
showscale (boolean)
default: true
Determines whether or not a colorbar is displayed for this trace.
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
colorbar (named list)
- thicknessmode (enumerated: "fraction" | "pixels")
  default: "pixels"
  Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
- thickness (number greater than or equal to 0)
  default: 30
  Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- lenmode (enumerated: "fraction" | "pixels")
  default: "fraction"
  Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
- len (number greater than or equal to 0)
  default: 1
  Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- x (number)
  default: 1.02
  Sets the x position of the color bar (in plot fraction).
- xanchor (enumerated: "left" | "center" | "right")
  default: "left"
  Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
- xpad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the x direction.
- y (number)
  default: 0.5
  Sets the y position of the color bar (in plot fraction).
- yanchor (enumerated: "top" | "middle" | "bottom")
  default: "middle"
  Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
- ypad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the y direction.
- outlinecolor (color)
  default: "#444"
  Sets the axis line color.
- outlinewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- bordercolor (color)
  default: "#444"
  Sets the axis line color.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) or the border enclosing this color bar.
- bgcolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of padded area.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  default: ""
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- title (string)
  default: "Click to enter colorscale title"
  Sets the title of the color bar.
- titlefont (named list)
  Sets this color bar's title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- titleside (enumerated: "right" | "top" | "bottom")
  default: "top"
  Determines the location of the colorbar title with respect to the color bar.
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
geo (geoid)
default: geo
Sets a reference between this trace's geospatial coordinates and a geographic map. If "geo" (the default value), the geospatial coordinates refer to `layout.geo`. If "geo2", the geospatial coordinates refer to `layout.geo2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
locationssrc (string)
Sets the source reference on plot.ly for locations .
zsrc (string)
Sets the source reference on plot.ly for z .
textsrc (string)
Sets the source reference on plot.ly for text .

area

A area trace is initialized with plot_ly or add_trace:

plot_ly(df, type="area"[, ...])

                      add_trace(p, type="area"[, ...])

A area trace accepts any of the keys listed below.

type ("area")
r (dataframe column, list, vector)
For polar chart only.Sets the radial coordinates.
t (dataframe column, list, vector)
For polar chart only.Sets the angular coordinates.
marker (named list)
- color (color)
  Sets the marker color.
- size (number greater than or equal to 0)
  default: 6
  Sets the marker size (in px).
- symbol (enumerated: "0" | "circle" | "100" | "circle-open" | "200" | "circle-dot" | "300" | "circle-open-dot" | "1" | "square" | "101" | "square-open" | "201" | "square-dot" | "301" | "square-open-dot" | "2" | "diamond" | "102" | "diamond-open" | "202" | "diamond-dot" | "302" | "diamond-open-dot" | "3" | "cross" | "103" | "cross-open" | "203" | "cross-dot" | "303" | "cross-open-dot" | "4" | "x" | "104" | "x-open" | "204" | "x-dot" | "304" | "x-open-dot" | "5" | "triangle-up" | "105" | "triangle-up-open" | "205" | "triangle-up-dot" | "305" | "triangle-up-open-dot" | "6" | "triangle-down" | "106" | "triangle-down-open" | "206" | "triangle-down-dot" | "306" | "triangle-down-open-dot" | "7" | "triangle-left" | "107" | "triangle-left-open" | "207" | "triangle-left-dot" | "307" | "triangle-left-open-dot" | "8" | "triangle-right" | "108" | "triangle-right-open" | "208" | "triangle-right-dot" | "308" | "triangle-right-open-dot" | "9" | "triangle-ne" | "109" | "triangle-ne-open" | "209" | "triangle-ne-dot" | "309" | "triangle-ne-open-dot" | "10" | "triangle-se" | "110" | "triangle-se-open" | "210" | "triangle-se-dot" | "310" | "triangle-se-open-dot" | "11" | "triangle-sw" | "111" | "triangle-sw-open" | "211" | "triangle-sw-dot" | "311" | "triangle-sw-open-dot" | "12" | "triangle-nw" | "112" | "triangle-nw-open" | "212" | "triangle-nw-dot" | "312" | "triangle-nw-open-dot" | "13" | "pentagon" | "113" | "pentagon-open" | "213" | "pentagon-dot" | "313" | "pentagon-open-dot" | "14" | "hexagon" | "114" | "hexagon-open" | "214" | "hexagon-dot" | "314" | "hexagon-open-dot" | "15" | "hexagon2" | "115" | "hexagon2-open" | "215" | "hexagon2-dot" | "315" | "hexagon2-open-dot" | "16" | "octagon" | "116" | "octagon-open" | "216" | "octagon-dot" | "316" | "octagon-open-dot" | "17" | "star" | "117" | "star-open" | "217" | "star-dot" | "317" | "star-open-dot" | "18" | "hexagram" | "118" | "hexagram-open" | "218" | "hexagram-dot" | "318" | "hexagram-open-dot" | "19" | "star-triangle-up" | "119" | "star-triangle-up-open" | "219" | "star-triangle-up-dot" | "319" | "star-triangle-up-open-dot" | "20" | "star-triangle-down" | "120" | "star-triangle-down-open" | "220" | "star-triangle-down-dot" | "320" | "star-triangle-down-open-dot" | "21" | "star-square" | "121" | "star-square-open" | "221" | "star-square-dot" | "321" | "star-square-open-dot" | "22" | "star-diamond" | "122" | "star-diamond-open" | "222" | "star-diamond-dot" | "322" | "star-diamond-open-dot" | "23" | "diamond-tall" | "123" | "diamond-tall-open" | "223" | "diamond-tall-dot" | "323" | "diamond-tall-open-dot" | "24" | "diamond-wide" | "124" | "diamond-wide-open" | "224" | "diamond-wide-dot" | "324" | "diamond-wide-open-dot" | "25" | "hourglass" | "125" | "hourglass-open" | "26" | "bowtie" | "126" | "bowtie-open" | "27" | "circle-cross" | "127" | "circle-cross-open" | "28" | "circle-x" | "128" | "circle-x-open" | "29" | "square-cross" | "129" | "square-cross-open" | "30" | "square-x" | "130" | "square-x-open" | "31" | "diamond-cross" | "131" | "diamond-cross-open" | "32" | "diamond-x" | "132" | "diamond-x-open" | "33" | "cross-thin" | "133" | "cross-thin-open" | "34" | "x-thin" | "134" | "x-thin-open" | "35" | "asterisk" | "135" | "asterisk-open" | "36" | "hash" | "136" | "hash-open" | "236" | "hash-dot" | "336" | "hash-open-dot" | "37" | "y-up" | "137" | "y-up-open" | "38" | "y-down" | "138" | "y-down-open" | "39" | "y-left" | "139" | "y-left-open" | "40" | "y-right" | "140" | "y-right-open" | "41" | "line-ew" | "141" | "line-ew-open" | "42" | "line-ns" | "142" | "line-ns-open" | "43" | "line-ne" | "143" | "line-ne-open" | "44" | "line-nw" | "144" | "line-nw-open")
  default: "circle"
  Sets the marker symbol type. Adding 100 is equivalent to appending "-open" to a symbol name. Adding 200 is equivalent to appending "-dot" to a symbol name. Adding 300 is equivalent to appending "-open-dot" or "dot-open" to a symbol name.
- opacity (number between or equal to 0 and 1)
  Sets the marker opacity.
- colorsrc (string)
  Sets the source reference on plot.ly for color .
- sizesrc (string)
  Sets the source reference on plot.ly for size .
- symbolsrc (string)
  Sets the source reference on plot.ly for symbol .
- opacitysrc (string)
  Sets the source reference on plot.ly for opacity .
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
rsrc (string)
Sets the source reference on plot.ly for r .
tsrc (string)
Sets the source reference on plot.ly for t .

layout

font (named list)
Sets the global font. Note that fonts used in traces and other layout components inherit from the global font.
- family (string)
  default: ""Open sans", verdana, arial, sans-serif"
- size (number greater than or equal to 1)
  default: 12
- color (color)
  default: "#444"
title (string)
default: "Click to enter Plot title"
Sets the plot's title.
titlefont (named list)
Sets the title font.
- family (string)
- size (number greater than or equal to 1)
- color (color)
autosize (enumerated: true | false | "initial")
Determines whether or not the dimensions of the figure are computed as a function of the display size.
width (number greater than or equal to 10)
default: 700
Sets the plot's width (in px).
height (number greater than or equal to 10)
default: 450
Sets the plot's height (in px).
margin (named list)
- l (number greater than or equal to 0)
  default: 80
  Sets the left margin (in px).
- r (number greater than or equal to 0)
  default: 80
  Sets the right margin (in px).
- t (number greater than or equal to 0)
  default: 100
  Sets the top margin (in px).
- b (number greater than or equal to 0)
  default: 80
  Sets the bottom margin (in px).
- pad (number greater than or equal to 0)
  default: 0
  Sets the amount of padding (in px) between the plotting area and the axis lines
- autoexpand (boolean)
  default: true
paper_bgcolor (color)
default: "#fff"
Sets the color of paper where the graph is drawn.
plot_bgcolor (color)
default: "#fff"
Sets the color of plotting area in-between x and y axes.
separators (string)
default: ".,"
Sets the decimal and thousand separators. For example, ". " puts a '.' before decimals and a space between thousands.
hidesources (boolean)
Determines whether or not a text link citing the data source is placed at the bottom-right cored of the figure. Has only an effect only on graphs that have been generated via forked graphs from the plotly cloud.
smith (enumerated: false)
showlegend (boolean)
Determines whether or not a legend is drawn.
dragmode (enumerated: "zoom" | "pan" | "orbit" | "turntable")
Determines the mode of drag interactions.
hovermode (enumerated: "x" | "y" | "closest" | false)
Determines the mode of hover interactions.
xaxis (named list)
- title (string)
  Sets the title of this axis.
- titlefont (named list)
  Sets this axis' title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- type (enumerated: "-" | "linear" | "log" | "date" | "category")
  default: "-"
  Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
- autorange (enumerated: true | false | "reversed")
  default: true
  Determines whether or not the range of this axis is computed in relation to the input data. See `rangemode` for more info. If `range` is provided, then `autorange` is set to "false".
- rangemode (enumerated: "normal" | "tozero" | "nonnegative")
  default: "normal"
  If "normal", the range is computed in relation to the extrema of the input data. If "tozero"`, the range extends to 0, regardless of the input data If "nonnegative", the range is non-negative, regardless of the input data.
- range (list)
  Sets the range of this axis.
- fixedrange (boolean)
  Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- mirror (enumerated: true | "ticks" | false | "all" | "allticks")
  Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If "true", the axis lines are mirrored. If "ticks", the axis lines and ticks are mirrored. If "false", mirroring is disable. If "all", axis lines are mirrored on all shared-axes subplots. If "allticks", axis lines and ticks are mirrored on all shared-axes subplots.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- hoverformat (string)
  default: ""
  Sets the hover text formatting rule for data values on this axis, using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- showline (boolean)
  Determines whether or not a line bounding this axis is drawn.
- linecolor (color)
  default: "#444"
  Sets the axis line color.
- linewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- showgrid (boolean)
  Determines whether or not grid lines are drawn. If "true", the grid lines are drawn at every tick mark.
- gridcolor (color)
  default: "#eee"
  Sets the color of the grid lines.
- gridwidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the grid lines.
- zeroline (boolean)
  Determines whether or not a line is drawn at along the 0 value of this axis. If "true", the zero line is drawn on top of the grid lines.
- zerolinecolor (color)
  default: "#444"
  Sets the line color of the zero line.
- zerolinewidth (number)
  default: 1
  Sets the width (in px) of the zero line.
- anchor (enumerated: "free" | "/^x([2-9]|[1-9][0-9]+)?$/" | "/^y([2-9]|[1-9][0-9]+)?$/")
  If set to an opposite-letter axis id (e.g. `xaxis2`, `yaxis`), this axis is bound to the corresponding opposite-letter axis. If set to "free", this axis' position is determined by `position`.
- side (enumerated: "top" | "bottom" | "left" | "right")
  Determines whether a x (y) axis is positioned at the "bottom" ("left") or "top" ("right") of the plotting area.
- overlaying (enumerated: "free" | "/^x([2-9]|[1-9][0-9]+)?$/" | "/^y([2-9]|[1-9][0-9]+)?$/")
  If set a same-letter axis id, this axis is overlaid on top of the corresponding same-letter axis. If "false", this axis does not overlay any same-letter axes.
- domain (list)
  default: [0, 1]
  Sets the domain of this axis (in plot fraction).
- position (number between or equal to 0 and 1)
  default: 0
  Sets the position of this axis in the plotting space (in normalized coordinates). Only has an effect if `anchor` is set to "free".
- _deprecated
- _isSubplotObj
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
yaxis (named list)
- title (string)
  Sets the title of this axis.
- titlefont (named list)
  Sets this axis' title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- type (enumerated: "-" | "linear" | "log" | "date" | "category")
  default: "-"
  Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
- autorange (enumerated: true | false | "reversed")
  default: true
  Determines whether or not the range of this axis is computed in relation to the input data. See `rangemode` for more info. If `range` is provided, then `autorange` is set to "false".
- rangemode (enumerated: "normal" | "tozero" | "nonnegative")
  default: "normal"
  If "normal", the range is computed in relation to the extrema of the input data. If "tozero"`, the range extends to 0, regardless of the input data If "nonnegative", the range is non-negative, regardless of the input data.
- range (list)
  Sets the range of this axis.
- fixedrange (boolean)
  Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- mirror (enumerated: true | "ticks" | false | "all" | "allticks")
  Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If "true", the axis lines are mirrored. If "ticks", the axis lines and ticks are mirrored. If "false", mirroring is disable. If "all", axis lines are mirrored on all shared-axes subplots. If "allticks", axis lines and ticks are mirrored on all shared-axes subplots.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- hoverformat (string)
  default: ""
  Sets the hover text formatting rule for data values on this axis, using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- showline (boolean)
  Determines whether or not a line bounding this axis is drawn.
- linecolor (color)
  default: "#444"
  Sets the axis line color.
- linewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- showgrid (boolean)
  Determines whether or not grid lines are drawn. If "true", the grid lines are drawn at every tick mark.
- gridcolor (color)
  default: "#eee"
  Sets the color of the grid lines.
- gridwidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the grid lines.
- zeroline (boolean)
  Determines whether or not a line is drawn at along the 0 value of this axis. If "true", the zero line is drawn on top of the grid lines.
- zerolinecolor (color)
  default: "#444"
  Sets the line color of the zero line.
- zerolinewidth (number)
  default: 1
  Sets the width (in px) of the zero line.
- anchor (enumerated: "free" | "/^x([2-9]|[1-9][0-9]+)?$/" | "/^y([2-9]|[1-9][0-9]+)?$/")
  If set to an opposite-letter axis id (e.g. `xaxis2`, `yaxis`), this axis is bound to the corresponding opposite-letter axis. If set to "free", this axis' position is determined by `position`.
- side (enumerated: "top" | "bottom" | "left" | "right")
  Determines whether a x (y) axis is positioned at the "bottom" ("left") or "top" ("right") of the plotting area.
- overlaying (enumerated: "free" | "/^x([2-9]|[1-9][0-9]+)?$/" | "/^y([2-9]|[1-9][0-9]+)?$/")
  If set a same-letter axis id, this axis is overlaid on top of the corresponding same-letter axis. If "false", this axis does not overlay any same-letter axes.
- domain (list)
  default: [0, 1]
  Sets the domain of this axis (in plot fraction).
- position (number between or equal to 0 and 1)
  default: 0
  Sets the position of this axis in the plotting space (in normalized coordinates). Only has an effect if `anchor` is set to "free".
- _deprecated
- _isSubplotObj
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
scene (named list)
- bgcolor (color)
  default: "rgba(0,0,0,0)"
- camera (named list)
  - up (named list)
    Sets the (x,y,z) components of the 'up' camera vector. This vector determines the up direction of this scene with respect to the page. The default is "{x: 0, y: 0, z: 1}" which means that the z axis points up.
    - x (number)
      default: 0
    - y (number)
      default: 0
    - z (number)
      default: 1
  - center (named list)
    Sets the (x,y,z) components of the 'center' camera vector This vector determines the translation (x,y,z) space about the center of this scene. By default, there is no such translation.
    - x (number)
      default: 0
    - y (number)
      default: 0
    - z (number)
      default: 0
  - eye (named list)
    Sets the (x,y,z) components of the 'eye' camera vector. This vector determines the view point about the origin of this scene.
    - x (number)
      default: 1.25
    - y (number)
      default: 1.25
    - z (number)
      default: 1.25
- domain (named list)
  - x (list)
    default: [0, 1]
    Sets the horizontal domain of this scene (in plot fraction).
  - y (list)
    default: [0, 1]
    Sets the vertical domain of this scene (in plot fraction).
- aspectmode (enumerated: "auto" | "cube" | "data" | "manual")
  default: "auto"
  If "cube", this scene's axes are drawn as a cube, regardless of the axes' ranges. If "data", this scene's axes are drawn in proportion with the axes' ranges. If "manual", this scene's axes are drawn in proportion with the input of "aspectratio" (the default behavior if "aspectratio" is provided). If "auto", this scene's axes are drawn using the results of "data" except when one axis is more than four times the size of the two others, where in that case the results of "cube" are used.
- aspectratio (named list)
  Sets this scene's axis aspectratio.
  - x (number greater than or equal to 0)
  - y (number greater than or equal to 0)
  - z (number greater than or equal to 0)
- xaxis (named list)
  - showspikes (boolean)
    default: true
    Sets whether or not spikes starting from data points to this axis' wall are shown on hover.
  - spikesides (boolean)
    default: true
    Sets whether or not spikes extending from the projection data points to this axis' wall boundaries are shown on hover.
  - spikethickness (number greater than or equal to 0)
    default: 2
    Sets the thickness (in px) of the spikes.
  - spikecolor (color)
    default: "rgb(0,0,0)"
    Sets the color of the spikes.
  - showbackground (boolean)
    Sets whether or not this axis' wall has a background color.
  - backgroundcolor (color)
    default: "rgba(204, 204, 204, 0.5)"
    Sets the background color of this axis' wall.
  - showaxeslabels (boolean)
    default: true
    Sets whether or not this axis is labeled
  - title (string)
    Sets the title of this axis.
  - titlefont (named list)
    Sets this axis' title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - type (enumerated: "-" | "linear" | "log" | "date" | "category")
    default: "-"
    Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
  - autorange (enumerated: true | false | "reversed")
    default: true
    Determines whether or not the range of this axis is computed in relation to the input data. See `rangemode` for more info. If `range` is provided, then `autorange` is set to "false".
  - rangemode (enumerated: "normal" | "tozero" | "nonnegative")
    default: "normal"
    If "normal", the range is computed in relation to the extrema of the input data. If "tozero"`, the range extends to 0, regardless of the input data If "nonnegative", the range is non-negative, regardless of the input data.
  - range (list)
    Sets the range of this axis.
  - fixedrange (boolean)
    Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - mirror (enumerated: true | "ticks" | false | "all" | "allticks")
    Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If "true", the axis lines are mirrored. If "ticks", the axis lines and ticks are mirrored. If "false", mirroring is disable. If "all", axis lines are mirrored on all shared-axes subplots. If "allticks", axis lines and ticks are mirrored on all shared-axes subplots.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - hoverformat (string)
    default: ""
    Sets the hover text formatting rule for data values on this axis, using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - showline (boolean)
    Determines whether or not a line bounding this axis is drawn.
  - linecolor (color)
    default: "#444"
    Sets the axis line color.
  - linewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - showgrid (boolean)
    Determines whether or not grid lines are drawn. If "true", the grid lines are drawn at every tick mark.
  - gridcolor (color)
    default: "rgb(204, 204, 204)"
    Sets the color of the grid lines.
  - gridwidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the grid lines.
  - zeroline (boolean)
    Determines whether or not a line is drawn at along the 0 value of this axis. If "true", the zero line is drawn on top of the grid lines.
  - zerolinecolor (color)
    default: "#444"
    Sets the line color of the zero line.
  - zerolinewidth (number)
    default: 1
    Sets the width (in px) of the zero line.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- yaxis (named list)
  - showspikes (boolean)
    default: true
    Sets whether or not spikes starting from data points to this axis' wall are shown on hover.
  - spikesides (boolean)
    default: true
    Sets whether or not spikes extending from the projection data points to this axis' wall boundaries are shown on hover.
  - spikethickness (number greater than or equal to 0)
    default: 2
    Sets the thickness (in px) of the spikes.
  - spikecolor (color)
    default: "rgb(0,0,0)"
    Sets the color of the spikes.
  - showbackground (boolean)
    Sets whether or not this axis' wall has a background color.
  - backgroundcolor (color)
    default: "rgba(204, 204, 204, 0.5)"
    Sets the background color of this axis' wall.
  - showaxeslabels (boolean)
    default: true
    Sets whether or not this axis is labeled
  - title (string)
    Sets the title of this axis.
  - titlefont (named list)
    Sets this axis' title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - type (enumerated: "-" | "linear" | "log" | "date" | "category")
    default: "-"
    Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
  - autorange (enumerated: true | false | "reversed")
    default: true
    Determines whether or not the range of this axis is computed in relation to the input data. See `rangemode` for more info. If `range` is provided, then `autorange` is set to "false".
  - rangemode (enumerated: "normal" | "tozero" | "nonnegative")
    default: "normal"
    If "normal", the range is computed in relation to the extrema of the input data. If "tozero"`, the range extends to 0, regardless of the input data If "nonnegative", the range is non-negative, regardless of the input data.
  - range (list)
    Sets the range of this axis.
  - fixedrange (boolean)
    Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - mirror (enumerated: true | "ticks" | false | "all" | "allticks")
    Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If "true", the axis lines are mirrored. If "ticks", the axis lines and ticks are mirrored. If "false", mirroring is disable. If "all", axis lines are mirrored on all shared-axes subplots. If "allticks", axis lines and ticks are mirrored on all shared-axes subplots.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - hoverformat (string)
    default: ""
    Sets the hover text formatting rule for data values on this axis, using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - showline (boolean)
    Determines whether or not a line bounding this axis is drawn.
  - linecolor (color)
    default: "#444"
    Sets the axis line color.
  - linewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - showgrid (boolean)
    Determines whether or not grid lines are drawn. If "true", the grid lines are drawn at every tick mark.
  - gridcolor (color)
    default: "rgb(204, 204, 204)"
    Sets the color of the grid lines.
  - gridwidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the grid lines.
  - zeroline (boolean)
    Determines whether or not a line is drawn at along the 0 value of this axis. If "true", the zero line is drawn on top of the grid lines.
  - zerolinecolor (color)
    default: "#444"
    Sets the line color of the zero line.
  - zerolinewidth (number)
    default: 1
    Sets the width (in px) of the zero line.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- zaxis (named list)
  - showspikes (boolean)
    default: true
    Sets whether or not spikes starting from data points to this axis' wall are shown on hover.
  - spikesides (boolean)
    default: true
    Sets whether or not spikes extending from the projection data points to this axis' wall boundaries are shown on hover.
  - spikethickness (number greater than or equal to 0)
    default: 2
    Sets the thickness (in px) of the spikes.
  - spikecolor (color)
    default: "rgb(0,0,0)"
    Sets the color of the spikes.
  - showbackground (boolean)
    Sets whether or not this axis' wall has a background color.
  - backgroundcolor (color)
    default: "rgba(204, 204, 204, 0.5)"
    Sets the background color of this axis' wall.
  - showaxeslabels (boolean)
    default: true
    Sets whether or not this axis is labeled
  - title (string)
    Sets the title of this axis.
  - titlefont (named list)
    Sets this axis' title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - type (enumerated: "-" | "linear" | "log" | "date" | "category")
    default: "-"
    Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
  - autorange (enumerated: true | false | "reversed")
    default: true
    Determines whether or not the range of this axis is computed in relation to the input data. See `rangemode` for more info. If `range` is provided, then `autorange` is set to "false".
  - rangemode (enumerated: "normal" | "tozero" | "nonnegative")
    default: "normal"
    If "normal", the range is computed in relation to the extrema of the input data. If "tozero"`, the range extends to 0, regardless of the input data If "nonnegative", the range is non-negative, regardless of the input data.
  - range (list)
    Sets the range of this axis.
  - fixedrange (boolean)
    Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - mirror (enumerated: true | "ticks" | false | "all" | "allticks")
    Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If "true", the axis lines are mirrored. If "ticks", the axis lines and ticks are mirrored. If "false", mirroring is disable. If "all", axis lines are mirrored on all shared-axes subplots. If "allticks", axis lines and ticks are mirrored on all shared-axes subplots.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - hoverformat (string)
    default: ""
    Sets the hover text formatting rule for data values on this axis, using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - showline (boolean)
    Determines whether or not a line bounding this axis is drawn.
  - linecolor (color)
    default: "#444"
    Sets the axis line color.
  - linewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - showgrid (boolean)
    Determines whether or not grid lines are drawn. If "true", the grid lines are drawn at every tick mark.
  - gridcolor (color)
    default: "rgb(204, 204, 204)"
    Sets the color of the grid lines.
  - gridwidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the grid lines.
  - zeroline (boolean)
    Determines whether or not a line is drawn at along the 0 value of this axis. If "true", the zero line is drawn on top of the grid lines.
  - zerolinecolor (color)
    default: "#444"
    Sets the line color of the zero line.
  - zerolinewidth (number)
    default: 1
    Sets the width (in px) of the zero line.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- _deprecated
- _isSubplotObj
geo (named list)
- domain (named list)
  - x (list)
    default: [0, 1]
    Sets the horizontal domain of this map (in plot fraction).
  - y (list)
    default: [0, 1]
    Sets the vertical domain of this map (in plot fraction).
- resolution (enumerated: "110" | "50")
  default: "110"
  Sets the resolution of the base layers. The values have units of km/mm e.g. 110 corresponds to a scale ratio of 1:110,000,000.
- scope (enumerated: "world" | "usa" | "europe" | "asia" | "africa" | "north america" | "south america")
  default: "world"
  Set the scope of the map.
- projection (named list)
  - type (enumerated: "equirectangular" | "mercator" | "orthographic" | "natural earth" | "kavrayskiy7" | "miller" | "robinson" | "eckert4" | "azimuthal equal area" | "azimuthal equidistant" | "conic equal area" | "conic conformal" | "conic equidistant" | "gnomonic" | "stereographic" | "mollweide" | "hammer" | "transverse mercator" | "albers usa")
    Sets the projection type.
  - rotation (named list)
    - lon (number)
      Rotates the map along parallels (in degrees East).
    - lat (number)
      Rotates the map along meridians (in degrees North).
    - roll (number)
      Roll the map (in degrees) For example, a roll of "180" makes the map appear upside down.
  - parallels (list)
    For conic projection types only. Sets the parallels (tangent, secant) where the cone intersects the sphere.
  - scale (number between or equal to 0 and 10)
    default: 1
    Zooms in or out on the map view.
- showcoastlines (boolean)
  Sets whether or not the coastlines are drawn.
- coastlinecolor (color)
  default: "#444"
  Sets the coastline color.
- coastlinewidth (number greater than or equal to 0)
  default: 1
  Sets the coastline stroke width (in px).
- showland (boolean)
  Sets whether or not land masses are filled in color.
- landcolor (color)
  default: "#F0DC82"
  Sets the land mass color.
- showocean (boolean)
  Sets whether or not oceans are filled in color.
- oceancolor (color)
  default: "#3399FF"
  Sets the ocean color
- showlakes (boolean)
  Sets whether or not lakes are drawn.
- lakecolor (color)
  default: "#3399FF"
  Sets the color of the lakes.
- showrivers (boolean)
  Sets whether or not rivers are drawn.
- rivercolor (color)
  default: "#3399FF"
  Sets color of the rivers.
- riverwidth (number greater than or equal to 0)
  default: 1
  Sets the stroke width (in px) of the rivers.
- showcountries (boolean)
  Sets whether or not country boundaries are drawn.
- countrycolor (color)
  default: "#444"
  Sets line color of the country boundaries.
- countrywidth (number greater than or equal to 0)
  default: 1
  Sets line width (in px) of the country boundaries.
- showsubunits (boolean)
  Sets whether or not boundaries of subunits within countries (e.g. states, provinces) are drawn.
- subunitcolor (color)
  default: "#444"
  Sets the color of the subunits boundaries.
- subunitwidth (number greater than or equal to 0)
  default: 1
  Sets the stroke width (in px) of the subunits boundaries.
- showframe (boolean)
  Sets whether or not a frame is drawn around the map.
- framecolor (color)
  default: "#444"
  Sets the color the frame.
- framewidth (number greater than or equal to 0)
  default: 1
  Sets the stroke width (in px) of the frame.
- bgcolor (color)
  default: "#fff"
  Set the background color of the map
- lonaxis (named list)
  - range (list)
    Sets the range of this axis (in degrees).
  - showgrid (boolean)
    Sets whether or not graticule are shown on the map.
  - tick0 (number)
    Sets the graticule's starting tick longitude/latitude.
  - dtick (number)
    Sets the graticule's longitude/latitude tick step.
  - gridcolor (color)
    default: "#eee"
    Sets the graticule's stroke color.
  - gridwidth (number greater than or equal to 0)
    default: 1
    Sets the graticule's stroke width (in px).
- lataxis (named list)
  - range (list)
    Sets the range of this axis (in degrees).
  - showgrid (boolean)
    Sets whether or not graticule are shown on the map.
  - tick0 (number)
    Sets the graticule's starting tick longitude/latitude.
  - dtick (number)
    Sets the graticule's longitude/latitude tick step.
  - gridcolor (color)
    default: "#eee"
    Sets the graticule's stroke color.
  - gridwidth (number greater than or equal to 0)
    default: 1
    Sets the graticule's stroke width (in px).
- _isSubplotObj
legend (named list)
- bgcolor (color)
  Sets the legend background color.
- bordercolor (color)
  default: "#444"
  Sets the color of the border enclosing the legend.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) of the border enclosing the legend.
- font (named list)
  Sets the font used to text the legend items.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- traceorder (flaglist)
  flags: "reversed" | "grouped"
  extras: "normal"
  examples: "reversed", "grouped", "reversed+grouped", "normal"
  Determines the order at which the legend items are displayed. If "normal", the items are displayed top-to-bottom in the same order as the input data. If "reversed", the items are displayed in the opposite order as "normal". If "grouped", the items are displayed in groups (when a trace `legendgroup` is provided). if "grouped+reversed", the items are displayed in the opposite order as "grouped".
- tracegroupgap (number greater than or equal to 0)
  default: 10
  Sets the amount of vertical space (in px) between legend groups.
- x (number between or equal to -2 and 3)
  default: 1.02
  Sets the x position (in normalized coordinates) of the legend.
- xanchor (enumerated: "auto" | "left" | "center" | "right")
  default: "left"
  Sets the legend's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the legend.
- y (number between or equal to -2 and 3)
  default: 1
  Sets the y position (in normalized coordinates) of the legend.
- yanchor (enumerated: "auto" | "top" | "middle" | "bottom")
  default: "auto"
  Sets the legend's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the legend.
annotations (named list)
- items
shapes (named list)
- items
radialaxis (named list)
- range (list)
  Defines the start and end point of this radial axis.
- domain (list)
  default: [0, 1]
  Polar chart subplots are not supported yet. This key has currently no effect.
- orientation (number)
  Sets the orientation (an angle with respect to the origin) of the radial axis.
- showline (boolean)
  Determines whether or not the line bounding this radial axis will be shown on the figure.
- showticklabels (boolean)
  Determines whether or not the radial axis ticks will feature tick labels.
- tickorientation (enumerated: "horizontal" | "vertical")
  Sets the orientation (from the paper perspective) of the radial axis tick labels.
- ticklen (number greater than or equal to 0)
  Sets the length of the tick lines on this radial axis.
- tickcolor (color)
  Sets the color of the tick lines on this radial axis.
- ticksuffix (string)
  Sets the length of the tick lines on this radial axis.
- endpadding (number)
- visible (boolean)
  Determines whether or not this axis will be visible.
angularaxis (named list)
- range (list)
  Defines the start and end point of this angular axis.
- domain (list)
  default: [0, 1]
  Polar chart subplots are not supported yet. This key has currently no effect.
- showline (boolean)
  Determines whether or not the line bounding this angular axis will be shown on the figure.
- showticklabels (boolean)
  Determines whether or not the angular axis ticks will feature tick labels.
- tickorientation (enumerated: "horizontal" | "vertical")
  Sets the orientation (from the paper perspective) of the angular axis tick labels.
- ticklen (number greater than or equal to 0)
  Sets the length of the tick lines on this angular axis.
- tickcolor (color)
  Sets the color of the tick lines on this angular axis.
- ticksuffix (string)
  Sets the length of the tick lines on this angular axis.
- endpadding (number)
- visible (boolean)
  Determines whether or not this axis will be visible.
direction (enumerated: "clockwise" | "counterclockwise")
For polar plots only. Sets the direction corresponding to positive angles.
orientation (angle)
For polar plots only. Rotates the entire polar by the given angle.

scatter

type
x
x0
dx
y
y0
dy
text
mode
line
- color
- width
- shape
- smoothing
- dash
connectgaps
fill
fillcolor
marker
- symbol
- opacity
- size
- color
- maxdisplayed
- sizeref
- sizemin
- sizemode
- colorscale
- cauto
- cmax
- cmin
- autocolorscale
- reversescale
- showscale
- line
  - color
  - width
  - colorscale
  - cauto
  - cmax
  - cmin
  - autocolorscale
  - reversescale
  - colorsrc
  - widthsrc
- colorbar
  - thicknessmode
  - thickness
  - lenmode
  - len
  - x
  - xanchor
  - xpad
  - y
  - yanchor
  - ypad
  - outlinecolor
  - outlinewidth
  - bordercolor
  - borderwidth
  - bgcolor
  - tickmode
  - nticks
  - tick0
  - dtick
  - tickvals
  - ticktext
  - ticks
  - ticklen
  - tickwidth
  - tickcolor
  - showticklabels
  - tickfont
    - family
    - size
    - color
  - tickangle
  - tickformat
  - tickprefix
  - showtickprefix
  - ticksuffix
  - showticksuffix
  - exponentformat
  - showexponent
  - title
  - titlefont
    - family
    - size
    - color
  - titleside
  - tickvalssrc
  - ticktextsrc
- symbolsrc
- opacitysrc
- sizesrc
- colorsrc
textposition
textfont
- family
- size
- color
- familysrc
- sizesrc
- colorsrc
r
t
error_y
- visible
- type
- symmetric
- array
- arrayminus
- value
- valueminus
- traceref
- tracerefminus
- copy_ystyle
- copy_zstyle
- color
- thickness
- width
- _deprecated
- arraysrc
- arrayminussrc
error_x
- visible
- type
- symmetric
- array
- arrayminus
- value
- valueminus
- traceref
- tracerefminus
- copy_ystyle
- copy_zstyle
- color
- thickness
- width
- _deprecated
- arraysrc
- arrayminussrc
xaxis
yaxis
visible
showlegend
legendgroup
opacity
name
uid
hoverinfo
stream
- token
- maxpoints
xsrc
ysrc
textsrc
textpositionsrc
rsrc
tsrc

bar

type
x
x0
dx
y
y0
dy
text
orientation
marker
- color
- colorscale
- cauto
- cmax
- cmin
- autocolorscale
- reversescale
- showscale
- line
  - color
  - colorscale
  - cauto
  - cmax
  - cmin
  - width
  - autocolorscale
  - reversescale
  - colorsrc
  - widthsrc
- colorbar
  - thicknessmode
  - thickness
  - lenmode
  - len
  - x
  - xanchor
  - xpad
  - y
  - yanchor
  - ypad
  - outlinecolor
  - outlinewidth
  - bordercolor
  - borderwidth
  - bgcolor
  - tickmode
  - nticks
  - tick0
  - dtick
  - tickvals
  - ticktext
  - ticks
  - ticklen
  - tickwidth
  - tickcolor
  - showticklabels
  - tickfont
    - family
    - size
    - color
  - tickangle
  - tickformat
  - tickprefix
  - showtickprefix
  - ticksuffix
  - showticksuffix
  - exponentformat
  - showexponent
  - title
  - titlefont
    - family
    - size
    - color
  - titleside
  - tickvalssrc
  - ticktextsrc
- colorsrc
r
t
error_y
- visible
- type
- symmetric
- array
- arrayminus
- value
- valueminus
- traceref
- tracerefminus
- copy_ystyle
- copy_zstyle
- color
- thickness
- width
- _deprecated
- arraysrc
- arrayminussrc
error_x
- visible
- type
- symmetric
- array
- arrayminus
- value
- valueminus
- traceref
- tracerefminus
- copy_ystyle
- copy_zstyle
- color
- thickness
- width
- _deprecated
- arraysrc
- arrayminussrc
_deprecated
xaxis
yaxis
visible
showlegend
legendgroup
opacity
name
uid
hoverinfo
stream
- token
- maxpoints
xsrc
ysrc
textsrc
rsrc
tsrc

box

type
y
x
x0
y0
whiskerwidth
boxpoints
boxmean
jitter
pointpos
orientation
marker
- outliercolor
- symbol
- opacity
- size
- color
- line
  - color
  - width
  - outliercolor
  - outlierwidth
line
- color
- width
fillcolor
xaxis
yaxis
visible
showlegend
legendgroup
opacity
name
uid
hoverinfo
stream
- token
- maxpoints
ysrc
xsrc

heatmap

type
z
x
x0
dx
y
y0
dy
text
transpose
xtype
ytype
zauto
zmin
zmax
colorscale
autocolorscale
reversescale
showscale
zsmooth
connectgaps
colorbar
- thicknessmode
- thickness
- lenmode
- len
- x
- xanchor
- xpad
- y
- yanchor
- ypad
- outlinecolor
- outlinewidth
- bordercolor
- borderwidth
- bgcolor
- tickmode
- nticks
- tick0
- dtick
- tickvals
- ticktext
- ticks
- ticklen
- tickwidth
- tickcolor
- showticklabels
- tickfont
  - family
  - size
  - color
- tickangle
- tickformat
- tickprefix
- showtickprefix
- ticksuffix
- showticksuffix
- exponentformat
- showexponent
- title
- titlefont
  - family
  - size
  - color
- titleside
- tickvalssrc
- ticktextsrc
xaxis
yaxis
visible
showlegend
legendgroup
opacity
name
uid
hoverinfo
stream
- token
- maxpoints
zsrc
xsrc
ysrc
textsrc

histogram

type
x
x0
dx
y
y0
dy
text
orientation
marker
- color
- colorscale
- cauto
- cmax
- cmin
- autocolorscale
- reversescale
- showscale
- line
  - color
  - colorscale
  - cauto
  - cmax
  - cmin
  - width
  - autocolorscale
  - reversescale
  - colorsrc
  - widthsrc
- colorbar
  - thicknessmode
  - thickness
  - lenmode
  - len
  - x
  - xanchor
  - xpad
  - y
  - yanchor
  - ypad
  - outlinecolor
  - outlinewidth
  - bordercolor
  - borderwidth
  - bgcolor
  - tickmode
  - nticks
  - tick0
  - dtick
  - tickvals
  - ticktext
  - ticks
  - ticklen
  - tickwidth
  - tickcolor
  - showticklabels
  - tickfont
    - family
    - size
    - color
  - tickangle
  - tickformat
  - tickprefix
  - showtickprefix
  - ticksuffix
  - showticksuffix
  - exponentformat
  - showexponent
  - title
  - titlefont
    - family
    - size
    - color
  - titleside
  - tickvalssrc
  - ticktextsrc
- colorsrc
r
t
z
histfunc
histnorm
autobinx
nbinsx
xbins
- start
- end
- size
autobiny
nbinsy
ybins
- start
- end
- size
error_y
- visible
- type
- symmetric
- array
- arrayminus
- value
- valueminus
- traceref
- tracerefminus
- copy_ystyle
- copy_zstyle
- color
- thickness
- width
- _deprecated
- arraysrc
- arrayminussrc
error_x
- visible
- type
- symmetric
- array
- arrayminus
- value
- valueminus
- traceref
- tracerefminus
- copy_ystyle
- copy_zstyle
- color
- thickness
- width
- _deprecated
- arraysrc
- arrayminussrc
_deprecated
xaxis
yaxis
visible
showlegend
legendgroup
opacity
name
uid
hoverinfo
stream
- token
- maxpoints
xsrc
ysrc
textsrc
rsrc
tsrc
zsrc

histogram2d

type
z
x
x0
dx
y
y0
dy
text
transpose
xtype
ytype
zauto
zmin
zmax
colorscale
autocolorscale
reversescale
showscale
zsmooth
connectgaps
colorbar
- thicknessmode
- thickness
- lenmode
- len
- x
- xanchor
- xpad
- y
- yanchor
- ypad
- outlinecolor
- outlinewidth
- bordercolor
- borderwidth
- bgcolor
- tickmode
- nticks
- tick0
- dtick
- tickvals
- ticktext
- ticks
- ticklen
- tickwidth
- tickcolor
- showticklabels
- tickfont
  - family
  - size
  - color
- tickangle
- tickformat
- tickprefix
- showtickprefix
- ticksuffix
- showticksuffix
- exponentformat
- showexponent
- title
- titlefont
  - family
  - size
  - color
- titleside
- tickvalssrc
- ticktextsrc
marker
- color
- colorsrc
orientation
histfunc
histnorm
autobinx
nbinsx
xbins
- start
- end
- size
autobiny
nbinsy
ybins
- start
- end
- size
xaxis
yaxis
visible
showlegend
legendgroup
opacity
name
uid
hoverinfo
stream
- token
- maxpoints
zsrc
xsrc
ysrc
textsrc

pie

type
labels
label0
dlabel
marker
- colors
- line
  - color
  - width
  - colorsrc
  - widthsrc
- colorssrc
text
scalegroup
textinfo
hoverinfo
textposition
textfont
- family
- size
- color
insidetextfont
- family
- size
- color
outsidetextfont
- family
- size
- color
domain
- x
- y
hole
sort
direction
rotation
pull
visible
showlegend
legendgroup
opacity
name
uid
stream
- token
- maxpoints
labelssrc
valuessrc
textsrc
textpositionsrc
pullsrc

contour

type
z
x
x0
dx
y
y0
dy
text
transpose
xtype
ytype
zauto
zmin
zmax
colorscale
autocolorscale
reversescale
showscale
zsmooth
connectgaps
colorbar
- thicknessmode
- thickness
- lenmode
- len
- x
- xanchor
- xpad
- y
- yanchor
- ypad
- outlinecolor
- outlinewidth
- bordercolor
- borderwidth
- bgcolor
- tickmode
- nticks
- tick0
- dtick
- tickvals
- ticktext
- ticks
- ticklen
- tickwidth
- tickcolor
- showticklabels
- tickfont
  - family
  - size
  - color
- tickangle
- tickformat
- tickprefix
- showtickprefix
- ticksuffix
- showticksuffix
- exponentformat
- showexponent
- title
- titlefont
  - family
  - size
  - color
- titleside
- tickvalssrc
- ticktextsrc
autocontour
ncontours
contours
- start
- end
- size
- coloring
- showlines
line
- color
- width
- dash
- smoothing
xaxis
yaxis
visible
showlegend
legendgroup
opacity
name
uid
hoverinfo
stream
- token
- maxpoints
zsrc
xsrc
ysrc
textsrc

histogram2dcontour

type
z
x
x0
dx
y
y0
dy
text
transpose
xtype
ytype
zauto
zmin
zmax
colorscale
autocolorscale
reversescale
showscale
zsmooth
connectgaps
colorbar
- thicknessmode
- thickness
- lenmode
- len
- x
- xanchor
- xpad
- y
- yanchor
- ypad
- outlinecolor
- outlinewidth
- bordercolor
- borderwidth
- bgcolor
- tickmode
- nticks
- tick0
- dtick
- tickvals
- ticktext
- ticks
- ticklen
- tickwidth
- tickcolor
- showticklabels
- tickfont
  - family
  - size
  - color
- tickangle
- tickformat
- tickprefix
- showtickprefix
- ticksuffix
- showticksuffix
- exponentformat
- showexponent
- title
- titlefont
  - family
  - size
  - color
- titleside
- tickvalssrc
- ticktextsrc
marker
- color
- colorsrc
orientation
histfunc
histnorm
autobinx
nbinsx
xbins
- start
- end
- size
autobiny
nbinsy
ybins
- start
- end
- size
autocontour
ncontours
contours
- start
- end
- size
- coloring
- showlines
line
- color
- width
- dash
- smoothing
xaxis
yaxis
visible
showlegend
legendgroup
opacity
name
uid
hoverinfo
stream
- token
- maxpoints
zsrc
xsrc
ysrc
textsrc

scatter3d

type
x
y
z
text
mode
surfaceaxis
surfacecolor
projection
- x
  - show
  - opacity
  - scale
- y
  - show
  - opacity
  - scale
- z
  - show
  - opacity
  - scale
line
- color
- width
- dash
marker
- color
- symbol
- size
- sizeref
- sizemin
- sizemode
- opacity
- colorscale
- cauto
- cmax
- cmin
- autocolorscale
- reversescale
- showscale
- line
  - color
  - width
  - colorscale
  - cauto
  - cmax
  - cmin
  - autocolorscale
  - reversescale
  - colorsrc
- colorbar
  - thicknessmode
  - thickness
  - lenmode
  - len
  - x
  - xanchor
  - xpad
  - y
  - yanchor
  - ypad
  - outlinecolor
  - outlinewidth
  - bordercolor
  - borderwidth
  - bgcolor
  - tickmode
  - nticks
  - tick0
  - dtick
  - tickvals
  - ticktext
  - ticks
  - ticklen
  - tickwidth
  - tickcolor
  - showticklabels
  - tickfont
    - family
    - size
    - color
  - tickangle
  - tickformat
  - tickprefix
  - showtickprefix
  - ticksuffix
  - showticksuffix
  - exponentformat
  - showexponent
  - title
  - titlefont
    - family
    - size
    - color
  - titleside
  - tickvalssrc
  - ticktextsrc
- colorsrc
- symbolsrc
- sizesrc
- opacitysrc
textposition
textfont
- family
- size
- color
- familysrc
- sizesrc
- colorsrc
error_x
- visible
- type
- symmetric
- array
- arrayminus
- value
- valueminus
- traceref
- tracerefminus
- copy_ystyle
- copy_zstyle
- color
- thickness
- width
- _deprecated
- arraysrc
- arrayminussrc
error_y
- visible
- type
- symmetric
- array
- arrayminus
- value
- valueminus
- traceref
- tracerefminus
- copy_ystyle
- copy_zstyle
- color
- thickness
- width
- _deprecated
- arraysrc
- arrayminussrc
error_z
- visible
- type
- symmetric
- array
- arrayminus
- value
- valueminus
- traceref
- tracerefminus
- copy_ystyle
- copy_zstyle
- color
- thickness
- width
- _deprecated
- arraysrc
- arrayminussrc
scene
visible
showlegend
legendgroup
opacity
name
uid
hoverinfo
stream
- token
- maxpoints
xsrc
ysrc
zsrc
textsrc
textpositionsrc

surface

type
z
x
y
text
zauto
zmin
zmax
colorscale
autocolorscale
reversescale
showscale
contours
- x
  - show
  - project
    - x
    - y
    - z
  - color
  - usecolormap
  - width
  - highlight
  - highlightColor
  - highlightWidth
- y
  - show
  - project
    - x
    - y
    - z
  - color
  - usecolormap
  - width
  - highlight
  - highlightColor
  - highlightWidth
- z
  - show
  - project
    - x
    - y
    - z
  - color
  - usecolormap
  - width
  - highlight
  - highlightColor
  - highlightWidth
hidesurface
lighting
- ambient
- diffuse
- specular
- roughness
- fresnel
opacity
colorbar
- thicknessmode
- thickness
- lenmode
- len
- x
- xanchor
- xpad
- y
- yanchor
- ypad
- outlinecolor
- outlinewidth
- bordercolor
- borderwidth
- bgcolor
- tickmode
- nticks
- tick0
- dtick
- tickvals
- ticktext
- ticks
- ticklen
- tickwidth
- tickcolor
- showticklabels
- tickfont
  - family
  - size
  - color
- tickangle
- tickformat
- tickprefix
- showtickprefix
- ticksuffix
- showticksuffix
- exponentformat
- showexponent
- title
- titlefont
  - family
  - size
  - color
- titleside
- tickvalssrc
- ticktextsrc
scene
visible
showlegend
legendgroup
name
uid
hoverinfo
stream
- token
- maxpoints
zsrc
xsrc
ysrc
textsrc

mesh3d

type
x
y
z
i
j
k
delaunayaxis
alphahull
intensity
color
vertexcolor
facecolor
opacity
flatshading
contour
- show
- color
- width
colorscale
reversescale
showscale
lighting
- ambient
- diffuse
- specular
- roughness
- fresnel
colorbar
- thicknessmode
- thickness
- lenmode
- len
- x
- xanchor
- xpad
- y
- yanchor
- ypad
- outlinecolor
- outlinewidth
- bordercolor
- borderwidth
- bgcolor
- tickmode
- nticks
- tick0
- dtick
- tickvals
- ticktext
- ticks
- ticklen
- tickwidth
- tickcolor
- showticklabels
- tickfont
  - family
  - size
  - color
- tickangle
- tickformat
- tickprefix
- showtickprefix
- ticksuffix
- showticksuffix
- exponentformat
- showexponent
- title
- titlefont
  - family
  - size
  - color
- titleside
- tickvalssrc
- ticktextsrc
scene
visible
showlegend
legendgroup
name
uid
hoverinfo
stream
- token
- maxpoints
xsrc
ysrc
zsrc
isrc
jsrc
ksrc
intensitysrc
vertexcolorsrc
facecolorsrc

scattergeo

type
lon
lat
locations
locationmode
mode
text
line
- color
- width
- dash
marker
- symbol
- opacity
- size
- sizeref
- sizemin
- sizemode
- color
- colorscale
- cauto
- cmax
- cmin
- autocolorscale
- reversescale
- showscale
- line
  - color
  - width
  - colorscale
  - cauto
  - cmax
  - cmin
  - autocolorscale
  - reversescale
  - colorsrc
  - widthsrc
- colorbar
  - thicknessmode
  - thickness
  - lenmode
  - len
  - x
  - xanchor
  - xpad
  - y
  - yanchor
  - ypad
  - outlinecolor
  - outlinewidth
  - bordercolor
  - borderwidth
  - bgcolor
  - tickmode
  - nticks
  - tick0
  - dtick
  - tickvals
  - ticktext
  - ticks
  - ticklen
  - tickwidth
  - tickcolor
  - showticklabels
  - tickfont
    - family
    - size
    - color
  - tickangle
  - tickformat
  - tickprefix
  - showtickprefix
  - ticksuffix
  - showticksuffix
  - exponentformat
  - showexponent
  - title
  - titlefont
    - family
    - size
    - color
  - titleside
  - tickvalssrc
  - ticktextsrc
- symbolsrc
- opacitysrc
- sizesrc
- colorsrc
textfont
- family
- size
- color
- familysrc
- sizesrc
- colorsrc
textposition
hoverinfo
geo
visible
showlegend
legendgroup
opacity
name
uid
stream
- token
- maxpoints
lonsrc
latsrc
locationssrc
textsrc
textpositionsrc

choropleth

type
locations
locationmode
z
text
marker
- line
  - color
  - width
  - colorsrc
  - widthsrc
zauto
zmin
zmax
colorscale
autocolorscale
reversescale
showscale
hoverinfo
colorbar
- thicknessmode
- thickness
- lenmode
- len
- x
- xanchor
- xpad
- y
- yanchor
- ypad
- outlinecolor
- outlinewidth
- bordercolor
- borderwidth
- bgcolor
- tickmode
- nticks
- tick0
- dtick
- tickvals
- ticktext
- ticks
- ticklen
- tickwidth
- tickcolor
- showticklabels
- tickfont
  - family
  - size
  - color
- tickangle
- tickformat
- tickprefix
- showtickprefix
- ticksuffix
- showticksuffix
- exponentformat
- showexponent
- title
- titlefont
  - family
  - size
  - color
- titleside
- tickvalssrc
- ticktextsrc
geo
visible
showlegend
legendgroup
opacity
name
uid
stream
- token
- maxpoints
locationssrc
zsrc
textsrc

area

type
r
t
marker
- color
- size
- symbol
- opacity
- colorsrc
- sizesrc
- symbolsrc
- opacitysrc
visible
showlegend
legendgroup
opacity
name
uid
hoverinfo
stream
- token
- maxpoints
rsrc
tsrc

layout

font
- family
- size
- color
title
titlefont
- family
- size
- color
autosize
width
height
margin
- l
- r
- t
- b
- pad
- autoexpand
paper_bgcolor
plot_bgcolor
separators
hidesources
smith
showlegend
dragmode
hovermode
xaxis
- title
- titlefont
  - family
  - size
  - color
- type
- autorange
- rangemode
- range
- fixedrange
- tickmode
- nticks
- tick0
- dtick
- tickvals
- ticktext
- ticks
- mirror
- ticklen
- tickwidth
- tickcolor
- showticklabels
- tickfont
  - family
  - size
  - color
- tickangle
- tickprefix
- showtickprefix
- ticksuffix
- showticksuffix
- showexponent
- exponentformat
- tickformat
- hoverformat
- showline
- linecolor
- linewidth
- showgrid
- gridcolor
- gridwidth
- zeroline
- zerolinecolor
- zerolinewidth
- anchor
- side
- overlaying
- domain
- position
- _deprecated
- _isSubplotObj
- tickvalssrc
- ticktextsrc
yaxis
- title
- titlefont
  - family
  - size
  - color
- type
- autorange
- rangemode
- range
- fixedrange
- tickmode
- nticks
- tick0
- dtick
- tickvals
- ticktext
- ticks
- mirror
- ticklen
- tickwidth
- tickcolor
- showticklabels
- tickfont
  - family
  - size
  - color
- tickangle
- tickprefix
- showtickprefix
- ticksuffix
- showticksuffix
- showexponent
- exponentformat
- tickformat
- hoverformat
- showline
- linecolor
- linewidth
- showgrid
- gridcolor
- gridwidth
- zeroline
- zerolinecolor
- zerolinewidth
- anchor
- side
- overlaying
- domain
- position
- _deprecated
- _isSubplotObj
- tickvalssrc
- ticktextsrc
scene
- bgcolor
- camera
  - up
    - x
    - y
    - z
  - center
    - x
    - y
    - z
  - eye
    - x
    - y
    - z
- domain
  - x
  - y
- aspectmode
- aspectratio
  - x
  - y
  - z
- xaxis
  - showspikes
  - spikesides
  - spikethickness
  - spikecolor
  - showbackground
  - backgroundcolor
  - showaxeslabels
  - title
  - titlefont
    - family
    - size
    - color
  - type
  - autorange
  - rangemode
  - range
  - fixedrange
  - tickmode
  - nticks
  - tick0
  - dtick
  - tickvals
  - ticktext
  - ticks
  - mirror
  - ticklen
  - tickwidth
  - tickcolor
  - showticklabels
  - tickfont
    - family
    - size
    - color
  - tickangle
  - tickprefix
  - showtickprefix
  - ticksuffix
  - showticksuffix
  - showexponent
  - exponentformat
  - tickformat
  - hoverformat
  - showline
  - linecolor
  - linewidth
  - showgrid
  - gridcolor
  - gridwidth
  - zeroline
  - zerolinecolor
  - zerolinewidth
  - tickvalssrc
  - ticktextsrc
- yaxis
  - showspikes
  - spikesides
  - spikethickness
  - spikecolor
  - showbackground
  - backgroundcolor
  - showaxeslabels
  - title
  - titlefont
    - family
    - size
    - color
  - type
  - autorange
  - rangemode
  - range
  - fixedrange
  - tickmode
  - nticks
  - tick0
  - dtick
  - tickvals
  - ticktext
  - ticks
  - mirror
  - ticklen
  - tickwidth
  - tickcolor
  - showticklabels
  - tickfont
    - family
    - size
    - color
  - tickangle
  - tickprefix
  - showtickprefix
  - ticksuffix
  - showticksuffix
  - showexponent
  - exponentformat
  - tickformat
  - hoverformat
  - showline
  - linecolor
  - linewidth
  - showgrid
  - gridcolor
  - gridwidth
  - zeroline
  - zerolinecolor
  - zerolinewidth
  - tickvalssrc
  - ticktextsrc
- zaxis
  - showspikes
  - spikesides
  - spikethickness
  - spikecolor
  - showbackground
  - backgroundcolor
  - showaxeslabels
  - title
  - titlefont
    - family
    - size
    - color
  - type
  - autorange
  - rangemode
  - range
  - fixedrange
  - tickmode
  - nticks
  - tick0
  - dtick
  - tickvals
  - ticktext
  - ticks
  - mirror
  - ticklen
  - tickwidth
  - tickcolor
  - showticklabels
  - tickfont
    - family
    - size
    - color
  - tickangle
  - tickprefix
  - showtickprefix
  - ticksuffix
  - showticksuffix
  - showexponent
  - exponentformat
  - tickformat
  - hoverformat
  - showline
  - linecolor
  - linewidth
  - showgrid
  - gridcolor
  - gridwidth
  - zeroline
  - zerolinecolor
  - zerolinewidth
  - tickvalssrc
  - ticktextsrc
- _deprecated
- _isSubplotObj
geo
- domain
  - x
  - y
- resolution
- scope
- projection
  - type
  - rotation
    - lon
    - lat
    - roll
  - parallels
  - scale
- showcoastlines
- coastlinecolor
- coastlinewidth
- showland
- landcolor
- showocean
- oceancolor
- showlakes
- lakecolor
- showrivers
- rivercolor
- riverwidth
- showcountries
- countrycolor
- countrywidth
- showsubunits
- subunitcolor
- subunitwidth
- showframe
- framecolor
- framewidth
- bgcolor
- lonaxis
  - range
  - showgrid
  - tick0
  - dtick
  - gridcolor
  - gridwidth
- lataxis
  - range
  - showgrid
  - tick0
  - dtick
  - gridcolor
  - gridwidth
- _isSubplotObj
legend
- bgcolor
- bordercolor
- borderwidth
- font
  - family
  - size
  - color
- traceorder
- tracegroupgap
- x
- xanchor
- y
- yanchor
annotations
- items
shapes
- items
radialaxis
- range
- domain
- orientation
- showline
- showticklabels
- tickorientation
- ticklen
- tickcolor
- ticksuffix
- endpadding
- visible
angularaxis
- range
- domain
- showline
- showticklabels
- tickorientation
- ticklen
- tickcolor
- ticksuffix
- endpadding
- visible
direction
orientation

scatter

A scatter trace is initialized with plot_ly or add_trace:

plot_ly(df, type="scatter"[, ...])

                      add_trace(p, type="scatter"[, ...])

type ("scatter")
x (dataframe column, list, vector)
Sets the x coordinates.
x0 (any)
default: 0
Alternate to `x`. Builds a linear space of x coordinates. Use with `dx` where `x0` is the starting coordinate and `dx` the step.
dx (number)
default: 1
Sets the x coordinate step. See `x0` for more info.
y (dataframe column, list, vector)
Sets the y coordinates.
y0 (any)
default: 0
Alternate to `y`. Builds a linear space of y coordinates. Use with `dy` where `y0` is the starting coordinate and `dy` the step.
dy (number)
default: 1
Sets the y coordinate step. See `y0` for more info.
text (string)
default: ""
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates.
mode (flaglist)
flags: "lines" | "markers" | "text"
extras: "none"
examples: "lines", "markers", "lines+markers", "lines+markers+text", "none"
Determines the drawing mode for this scatter trace. If the provided `mode` includes "text" then the `text` elements appear at the coordinates. Otherwise, the `text` elements appear on hover.
line (named list)
- color (color)
  Sets the line color.
- width (number greater than or equal to 0)
  default: 2
  Sets the line width (in px).
- shape (enumerated: "linear" | "spline" | "hv" | "vh" | "hvh" | "vhv")
  default: "linear"
  Determines the line shape. With "spline" the lines are drawn using spline interpolation. The other available values correspond to step-wise line shapes.
- smoothing (number between or equal to 0 and 1.3)
  default: 1
  Has only an effect if `shape` is set to "spline" Sets the amount of smoothing. "0" corresponds to no smoothing (equivalent to a "linear" shape).
- dash (string)
  default: "solid"
  Sets the style of the lines.
connectgaps (boolean)
Determines whether or not gaps (i.e. {nan} or missing values) in the provided data arrays are connected.
fill (enumerated: "none" | "tozeroy" | "tozerox" | "tonexty" | "tonextx")
default: "none"
Sets the area to fill with a solid color. Use with `fillcolor`.
fillcolor (color)
Sets the fill color.
marker (named list)
- symbol (enumerated: "0" | "circle" | "100" | "circle-open" | "200" | "circle-dot" | "300" | "circle-open-dot" | "1" | "square" | "101" | "square-open" | "201" | "square-dot" | "301" | "square-open-dot" | "2" | "diamond" | "102" | "diamond-open" | "202" | "diamond-dot" | "302" | "diamond-open-dot" | "3" | "cross" | "103" | "cross-open" | "203" | "cross-dot" | "303" | "cross-open-dot" | "4" | "x" | "104" | "x-open" | "204" | "x-dot" | "304" | "x-open-dot" | "5" | "triangle-up" | "105" | "triangle-up-open" | "205" | "triangle-up-dot" | "305" | "triangle-up-open-dot" | "6" | "triangle-down" | "106" | "triangle-down-open" | "206" | "triangle-down-dot" | "306" | "triangle-down-open-dot" | "7" | "triangle-left" | "107" | "triangle-left-open" | "207" | "triangle-left-dot" | "307" | "triangle-left-open-dot" | "8" | "triangle-right" | "108" | "triangle-right-open" | "208" | "triangle-right-dot" | "308" | "triangle-right-open-dot" | "9" | "triangle-ne" | "109" | "triangle-ne-open" | "209" | "triangle-ne-dot" | "309" | "triangle-ne-open-dot" | "10" | "triangle-se" | "110" | "triangle-se-open" | "210" | "triangle-se-dot" | "310" | "triangle-se-open-dot" | "11" | "triangle-sw" | "111" | "triangle-sw-open" | "211" | "triangle-sw-dot" | "311" | "triangle-sw-open-dot" | "12" | "triangle-nw" | "112" | "triangle-nw-open" | "212" | "triangle-nw-dot" | "312" | "triangle-nw-open-dot" | "13" | "pentagon" | "113" | "pentagon-open" | "213" | "pentagon-dot" | "313" | "pentagon-open-dot" | "14" | "hexagon" | "114" | "hexagon-open" | "214" | "hexagon-dot" | "314" | "hexagon-open-dot" | "15" | "hexagon2" | "115" | "hexagon2-open" | "215" | "hexagon2-dot" | "315" | "hexagon2-open-dot" | "16" | "octagon" | "116" | "octagon-open" | "216" | "octagon-dot" | "316" | "octagon-open-dot" | "17" | "star" | "117" | "star-open" | "217" | "star-dot" | "317" | "star-open-dot" | "18" | "hexagram" | "118" | "hexagram-open" | "218" | "hexagram-dot" | "318" | "hexagram-open-dot" | "19" | "star-triangle-up" | "119" | "star-triangle-up-open" | "219" | "star-triangle-up-dot" | "319" | "star-triangle-up-open-dot" | "20" | "star-triangle-down" | "120" | "star-triangle-down-open" | "220" | "star-triangle-down-dot" | "320" | "star-triangle-down-open-dot" | "21" | "star-square" | "121" | "star-square-open" | "221" | "star-square-dot" | "321" | "star-square-open-dot" | "22" | "star-diamond" | "122" | "star-diamond-open" | "222" | "star-diamond-dot" | "322" | "star-diamond-open-dot" | "23" | "diamond-tall" | "123" | "diamond-tall-open" | "223" | "diamond-tall-dot" | "323" | "diamond-tall-open-dot" | "24" | "diamond-wide" | "124" | "diamond-wide-open" | "224" | "diamond-wide-dot" | "324" | "diamond-wide-open-dot" | "25" | "hourglass" | "125" | "hourglass-open" | "26" | "bowtie" | "126" | "bowtie-open" | "27" | "circle-cross" | "127" | "circle-cross-open" | "28" | "circle-x" | "128" | "circle-x-open" | "29" | "square-cross" | "129" | "square-cross-open" | "30" | "square-x" | "130" | "square-x-open" | "31" | "diamond-cross" | "131" | "diamond-cross-open" | "32" | "diamond-x" | "132" | "diamond-x-open" | "33" | "cross-thin" | "133" | "cross-thin-open" | "34" | "x-thin" | "134" | "x-thin-open" | "35" | "asterisk" | "135" | "asterisk-open" | "36" | "hash" | "136" | "hash-open" | "236" | "hash-dot" | "336" | "hash-open-dot" | "37" | "y-up" | "137" | "y-up-open" | "38" | "y-down" | "138" | "y-down-open" | "39" | "y-left" | "139" | "y-left-open" | "40" | "y-right" | "140" | "y-right-open" | "41" | "line-ew" | "141" | "line-ew-open" | "42" | "line-ns" | "142" | "line-ns-open" | "43" | "line-ne" | "143" | "line-ne-open" | "44" | "line-nw" | "144" | "line-nw-open")
  default: "circle"
  Sets the marker symbol type. Adding 100 is equivalent to appending "-open" to a symbol name. Adding 200 is equivalent to appending "-dot" to a symbol name. Adding 300 is equivalent to appending "-open-dot" or "dot-open" to a symbol name.
- opacity (number between or equal to 0 and 1)
  Sets the marker opacity.
- size (number greater than or equal to 0)
  default: 6
  Sets the marker size (in px).
- color (color)
  Sets the marker color.
- maxdisplayed (number greater than or equal to 0)
  default: 0
  Sets a maximum number of points to be drawn on the graph. "0" corresponds to no limit.
- sizeref (number)
  default: 1
  Has only an effect if `marker.size` is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with `sizemin` and `sizemode`.
- sizemin (number greater than or equal to 0)
  default: 0
  Has only an effect if `marker.size` is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
- sizemode (enumerated: "diameter" | "area")
  default: "diameter"
  Has only an effect if `marker.size` is set to a numerical array. Sets the rule for which the data in `size` is converted to pixels.
- colorscale (colorscale)
  Has only an effect if `marker.color` is set to a numerical array. Sets the colorscale.
- cauto (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines the whether or not the color domain is computed automatically.
- cmax (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the upper bound of the color domain.
- cmin (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the lower bound of the color domain.
- autocolorscale (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not the colorscale is picked using values inside `marker.color`.
- reversescale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Reverses the colorscale.
- showscale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not a colorbar is displayed.
- line (named list)
  - color (color)
    Sets the color of the lines bounding the marker points.
  - width (number greater than or equal to 0)
    Sets the width (in px) of the lines bounding the marker points.
  - colorscale (colorscale)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the colorscale.
  - cauto (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines the whether or not the color domain is computed with respect to the input data.
  - cmax (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the upper bound of the color domain.
  - cmin (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the lower bound of the color domain.
  - autocolorscale (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines whether or not the colorscale is picked using the sign of values inside `marker.line.color`.
  - reversescale (boolean)
    Has only an effect if `marker.color.line` is set to a numerical array. Reverses the colorscale.
  - colorsrc (string)
    Sets the source reference on plot.ly for color .
  - widthsrc (string)
    Sets the source reference on plot.ly for width .
- colorbar (named list)
  - thicknessmode (enumerated: "fraction" | "pixels")
    default: "pixels"
    Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
  - thickness (number greater than or equal to 0)
    default: 30
    Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
  - lenmode (enumerated: "fraction" | "pixels")
    default: "fraction"
    Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
  - len (number greater than or equal to 0)
    default: 1
    Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
  - x (number)
    default: 1.02
    Sets the x position of the color bar (in plot fraction).
  - xanchor (enumerated: "left" | "center" | "right")
    default: "left"
    Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
  - xpad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the x direction.
  - y (number)
    default: 0.5
    Sets the y position of the color bar (in plot fraction).
  - yanchor (enumerated: "top" | "middle" | "bottom")
    default: "middle"
    Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
  - ypad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the y direction.
  - outlinecolor (color)
    default: "#444"
    Sets the axis line color.
  - outlinewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - bordercolor (color)
    default: "#444"
    Sets the axis line color.
  - borderwidth (number greater than or equal to 0)
    default: 0
    Sets the width (in px) or the border enclosing this color bar.
  - bgcolor (color)
    default: "rgba(0,0,0,0)"
    Sets the color of padded area.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    default: ""
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - title (string)
    default: "Click to enter colorscale title"
    Sets the title of the color bar.
  - titlefont (named list)
    Sets this color bar's title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - titleside (enumerated: "right" | "top" | "bottom")
    default: "top"
    Determines the location of the colorbar title with respect to the color bar.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- symbolsrc (string)
  Sets the source reference on plot.ly for symbol .
- opacitysrc (string)
  Sets the source reference on plot.ly for opacity .
- sizesrc (string)
  Sets the source reference on plot.ly for size .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
textposition (enumerated: "top left" | "top center" | "top right" | "middle left" | "middle center" | "middle right" | "bottom left" | "bottom center" | "bottom right")
default: "middle center"
Sets the positions of the `text` elements with respects to the (x,y) coordinates.
textfont (named list)
Sets the text font.
- family (string)
- size (number greater than or equal to 1)
- color (color)
- familysrc (string)
  Sets the source reference on plot.ly for family .
- sizesrc (string)
  Sets the source reference on plot.ly for size .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
r (dataframe column, list, vector)
For polar chart only.Sets the radial coordinates.
t (dataframe column, list, vector)
For polar chart only.Sets the angular coordinates.
error_y (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
error_x (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .
textpositionsrc (string)
Sets the source reference on plot.ly for textposition .
rsrc (string)
Sets the source reference on plot.ly for r .
tsrc (string)
Sets the source reference on plot.ly for t .

bar

A bar trace is initialized with plot_ly or add_trace:

plot_ly(df, type="bar"[, ...])

                      add_trace(p, type="bar"[, ...])

type ("bar")
x (dataframe column, list, vector)
Sets the x coordinates.
x0 (any)
default: 0
Alternate to `x`. Builds a linear space of x coordinates. Use with `dx` where `x0` is the starting coordinate and `dx` the step.
dx (number)
default: 1
Sets the x coordinate step. See `x0` for more info.
y (dataframe column, list, vector)
Sets the y coordinates.
y0 (any)
default: 0
Alternate to `y`. Builds a linear space of y coordinates. Use with `dy` where `y0` is the starting coordinate and `dy` the step.
dy (number)
default: 1
Sets the y coordinate step. See `y0` for more info.
text (string)
default: ""
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates.
orientation (enumerated: "v" | "h")
Sets the orientation of the bars. With "v" ("h"), the value of the each bar spans along the vertical (horizontal).
marker (named list)
- color (color)
  Sets the marker color.
- colorscale (colorscale)
  Has only an effect if `marker.color` is set to a numerical array. Sets the colorscale.
- cauto (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines the whether or not the color domain is computed automatically.
- cmax (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the upper bound of the color domain.
- cmin (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the lower bound of the color domain.
- autocolorscale (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not the colorscale is picked using values inside `marker.color`.
- reversescale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Reverses the colorscale.
- showscale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not a colorbar is displayed.
- line (named list)
  - color (color)
    Sets the color of the lines bounding the marker points.
  - colorscale (colorscale)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the colorscale.
  - cauto (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines the whether or not the color domain is computed with respect to the input data.
  - cmax (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the upper bound of the color domain.
  - cmin (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the lower bound of the color domain.
  - width (number greater than or equal to 0)
    Sets the width (in px) of the lines bounding the marker points.
  - autocolorscale (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines whether or not the colorscale is picked using the sign of values inside `marker.line.color`.
  - reversescale (boolean)
    Has only an effect if `marker.color.line` is set to a numerical array. Reverses the colorscale.
  - colorsrc (string)
    Sets the source reference on plot.ly for color .
  - widthsrc (string)
    Sets the source reference on plot.ly for width .
- colorbar (named list)
  - thicknessmode (enumerated: "fraction" | "pixels")
    default: "pixels"
    Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
  - thickness (number greater than or equal to 0)
    default: 30
    Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
  - lenmode (enumerated: "fraction" | "pixels")
    default: "fraction"
    Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
  - len (number greater than or equal to 0)
    default: 1
    Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
  - x (number)
    default: 1.02
    Sets the x position of the color bar (in plot fraction).
  - xanchor (enumerated: "left" | "center" | "right")
    default: "left"
    Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
  - xpad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the x direction.
  - y (number)
    default: 0.5
    Sets the y position of the color bar (in plot fraction).
  - yanchor (enumerated: "top" | "middle" | "bottom")
    default: "middle"
    Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
  - ypad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the y direction.
  - outlinecolor (color)
    default: "#444"
    Sets the axis line color.
  - outlinewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - bordercolor (color)
    default: "#444"
    Sets the axis line color.
  - borderwidth (number greater than or equal to 0)
    default: 0
    Sets the width (in px) or the border enclosing this color bar.
  - bgcolor (color)
    default: "rgba(0,0,0,0)"
    Sets the color of padded area.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    default: ""
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - title (string)
    default: "Click to enter colorscale title"
    Sets the title of the color bar.
  - titlefont (named list)
    Sets this color bar's title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - titleside (enumerated: "right" | "top" | "bottom")
    default: "top"
    Determines the location of the colorbar title with respect to the color bar.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
r (dataframe column, list, vector)
For polar chart only.Sets the radial coordinates.
t (dataframe column, list, vector)
For polar chart only.Sets the angular coordinates.
error_y (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
error_x (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
_deprecated
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .
rsrc (string)
Sets the source reference on plot.ly for r .
tsrc (string)
Sets the source reference on plot.ly for t .

box

A box trace is initialized with plot_ly or add_trace:

plot_ly(df, type="box"[, ...])

                      add_trace(p, type="box"[, ...])

type ("box")
y (dataframe column, list, vector)
Sets the y sample data or coordinates. See overview for more info.
x (dataframe column, list, vector)
Sets the x sample data or coordinates. See overview for more info.
x0 (any)
Sets the x coordinate of the box. See overview for more info.
y0 (any)
Sets the y coordinate of the box. See overview for more info.
whiskerwidth (number between or equal to 0 and 1)
default: 0.5
Sets the width of the whiskers relative to the box' width. For example, with 1, the whiskers are as wide as the box(es).
boxpoints (enumerated: "all" | "outliers" | "suspectedoutliers" | false)
default: "outliers"
If "outliers", only the sample points lying outside the whiskers are shown If "suspectedoutliers", the outlier points are shown and points either less than 4"Q1-3"Q3 or greater than 4"Q3-3"Q1 are highlighted (see `outliercolor`) If "all", all sample points are shown If "false", only the box(es) are shown with no sample points
boxmean (enumerated: true | "sd" | false)
If "true", the mean of the box(es)' underlying distribution is drawn as a dashed line inside the box(es). If "sd" the standard deviation is also drawn.
jitter (number between or equal to 0 and 1)
Sets the amount of jitter in the sample points drawn. If "0", the sample points align along the distribution axis. If "1", the sample points are drawn in a random jitter of width equal to the width of the box(es).
pointpos (number between or equal to -2 and 2)
Sets the position of the sample points in relation to the box(es). If "0", the sample points are places over the center of the box(es). Positive (negative) values correspond to positions to the right (left) for vertical boxes and above (below) for horizontal boxes
orientation (enumerated: "v" | "h")
Sets the orientation of the box(es). If "v" ("h"), the distribution is visualized along the vertical (horizontal).
marker (named list)
- outliercolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of the outlier sample points.
- symbol (enumerated: "0" | "circle" | "100" | "circle-open" | "200" | "circle-dot" | "300" | "circle-open-dot" | "1" | "square" | "101" | "square-open" | "201" | "square-dot" | "301" | "square-open-dot" | "2" | "diamond" | "102" | "diamond-open" | "202" | "diamond-dot" | "302" | "diamond-open-dot" | "3" | "cross" | "103" | "cross-open" | "203" | "cross-dot" | "303" | "cross-open-dot" | "4" | "x" | "104" | "x-open" | "204" | "x-dot" | "304" | "x-open-dot" | "5" | "triangle-up" | "105" | "triangle-up-open" | "205" | "triangle-up-dot" | "305" | "triangle-up-open-dot" | "6" | "triangle-down" | "106" | "triangle-down-open" | "206" | "triangle-down-dot" | "306" | "triangle-down-open-dot" | "7" | "triangle-left" | "107" | "triangle-left-open" | "207" | "triangle-left-dot" | "307" | "triangle-left-open-dot" | "8" | "triangle-right" | "108" | "triangle-right-open" | "208" | "triangle-right-dot" | "308" | "triangle-right-open-dot" | "9" | "triangle-ne" | "109" | "triangle-ne-open" | "209" | "triangle-ne-dot" | "309" | "triangle-ne-open-dot" | "10" | "triangle-se" | "110" | "triangle-se-open" | "210" | "triangle-se-dot" | "310" | "triangle-se-open-dot" | "11" | "triangle-sw" | "111" | "triangle-sw-open" | "211" | "triangle-sw-dot" | "311" | "triangle-sw-open-dot" | "12" | "triangle-nw" | "112" | "triangle-nw-open" | "212" | "triangle-nw-dot" | "312" | "triangle-nw-open-dot" | "13" | "pentagon" | "113" | "pentagon-open" | "213" | "pentagon-dot" | "313" | "pentagon-open-dot" | "14" | "hexagon" | "114" | "hexagon-open" | "214" | "hexagon-dot" | "314" | "hexagon-open-dot" | "15" | "hexagon2" | "115" | "hexagon2-open" | "215" | "hexagon2-dot" | "315" | "hexagon2-open-dot" | "16" | "octagon" | "116" | "octagon-open" | "216" | "octagon-dot" | "316" | "octagon-open-dot" | "17" | "star" | "117" | "star-open" | "217" | "star-dot" | "317" | "star-open-dot" | "18" | "hexagram" | "118" | "hexagram-open" | "218" | "hexagram-dot" | "318" | "hexagram-open-dot" | "19" | "star-triangle-up" | "119" | "star-triangle-up-open" | "219" | "star-triangle-up-dot" | "319" | "star-triangle-up-open-dot" | "20" | "star-triangle-down" | "120" | "star-triangle-down-open" | "220" | "star-triangle-down-dot" | "320" | "star-triangle-down-open-dot" | "21" | "star-square" | "121" | "star-square-open" | "221" | "star-square-dot" | "321" | "star-square-open-dot" | "22" | "star-diamond" | "122" | "star-diamond-open" | "222" | "star-diamond-dot" | "322" | "star-diamond-open-dot" | "23" | "diamond-tall" | "123" | "diamond-tall-open" | "223" | "diamond-tall-dot" | "323" | "diamond-tall-open-dot" | "24" | "diamond-wide" | "124" | "diamond-wide-open" | "224" | "diamond-wide-dot" | "324" | "diamond-wide-open-dot" | "25" | "hourglass" | "125" | "hourglass-open" | "26" | "bowtie" | "126" | "bowtie-open" | "27" | "circle-cross" | "127" | "circle-cross-open" | "28" | "circle-x" | "128" | "circle-x-open" | "29" | "square-cross" | "129" | "square-cross-open" | "30" | "square-x" | "130" | "square-x-open" | "31" | "diamond-cross" | "131" | "diamond-cross-open" | "32" | "diamond-x" | "132" | "diamond-x-open" | "33" | "cross-thin" | "133" | "cross-thin-open" | "34" | "x-thin" | "134" | "x-thin-open" | "35" | "asterisk" | "135" | "asterisk-open" | "36" | "hash" | "136" | "hash-open" | "236" | "hash-dot" | "336" | "hash-open-dot" | "37" | "y-up" | "137" | "y-up-open" | "38" | "y-down" | "138" | "y-down-open" | "39" | "y-left" | "139" | "y-left-open" | "40" | "y-right" | "140" | "y-right-open" | "41" | "line-ew" | "141" | "line-ew-open" | "42" | "line-ns" | "142" | "line-ns-open" | "43" | "line-ne" | "143" | "line-ne-open" | "44" | "line-nw" | "144" | "line-nw-open")
  default: "circle"
  Sets the marker symbol type. Adding 100 is equivalent to appending "-open" to a symbol name. Adding 200 is equivalent to appending "-dot" to a symbol name. Adding 300 is equivalent to appending "-open-dot" or "dot-open" to a symbol name.
- opacity (number between or equal to 0 and 1)
  default: 1
  Sets the marker opacity.
- size (number greater than or equal to 0)
  default: 6
  Sets the marker size (in px).
- color (color)
  Sets the marker color.
- line (named list)
  - color (color)
    default: "#444"
    Sets the color of the lines bounding the marker points.
  - width (number greater than or equal to 0)
    default: 0
    Sets the width (in px) of the lines bounding the marker points.
  - outliercolor (color)
    Sets the border line color of the outlier sample points.
  - outlierwidth (number greater than or equal to 0)
    default: 1
    Sets the border line width (in px) of the outlier sample points.
line (named list)
- color (color)
  Sets the color of line bounding the box(es).
- width (number greater than or equal to 0)
  default: 2
  Sets the width (in px) of line bounding the box(es).
fillcolor (color)
Sets the fill color.
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
ysrc (string)
Sets the source reference on plot.ly for y .
xsrc (string)
Sets the source reference on plot.ly for x .

heatmap

A heatmap trace is initialized with plot_ly or add_trace:

plot_ly(df, type="heatmap"[, ...])

                      add_trace(p, type="heatmap"[, ...])

type ("heatmap")
z (dataframe column, list, vector)
Sets the z data.
x (dataframe column, list, vector)
Sets the x coordinates.
x0 (any)
default: 0
Alternate to `x`. Builds a linear space of x coordinates. Use with `dx` where `x0` is the starting coordinate and `dx` the step.
dx (number)
default: 1
Sets the x coordinate step. See `x0` for more info.
y (dataframe column, list, vector)
Sets the y coordinates.
y0 (any)
default: 0
Alternate to `y`. Builds a linear space of y coordinates. Use with `dy` where `y0` is the starting coordinate and `dy` the step.
dy (number)
default: 1
Sets the y coordinate step. See `y0` for more info.
text (dataframe column, list, vector)
Sets the text elements associated with each z value.
transpose (boolean)
Transposes the z data.
xtype (enumerated: "array" | "scaled")
If "array", the heatmap's x coordinates are given by "x" (the default behavior when `x` is provided). If "scaled", the heatmap's x coordinates are given by "x0" and "dx" (the default behavior when `x` is not provided).
ytype (enumerated: "array" | "scaled")
If "array", the heatmap's y coordinates are given by "y" (the default behavior when `y` is provided) If "scaled", the heatmap's y coordinates are given by "y0" and "dy" (the default behavior when `y` is not provided)
zauto (boolean)
default: true
Determines the whether or not the color domain is computed with respect to the input data.
zmin (number)
Sets the lower bound of color domain.
zmax (number)
Sets the upper bound of color domain.
colorscale (colorscale)
Sets the colorscale.
autocolorscale (boolean)
Determines whether or not the colorscale is picked using the sign of the input z values.
reversescale (boolean)
Reverses the colorscale.
showscale (boolean)
default: true
Determines whether or not a colorbar is displayed for this trace.
zsmooth (enumerated: "fast" | "best" | false)
Picks a smoothing algorithm use to smooth `z` data.
connectgaps (boolean)
Determines whether or not gaps (i.e. {nan} or missing values) in the `z` data are filled in.
colorbar (named list)
- thicknessmode (enumerated: "fraction" | "pixels")
  default: "pixels"
  Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
- thickness (number greater than or equal to 0)
  default: 30
  Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- lenmode (enumerated: "fraction" | "pixels")
  default: "fraction"
  Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
- len (number greater than or equal to 0)
  default: 1
  Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- x (number)
  default: 1.02
  Sets the x position of the color bar (in plot fraction).
- xanchor (enumerated: "left" | "center" | "right")
  default: "left"
  Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
- xpad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the x direction.
- y (number)
  default: 0.5
  Sets the y position of the color bar (in plot fraction).
- yanchor (enumerated: "top" | "middle" | "bottom")
  default: "middle"
  Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
- ypad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the y direction.
- outlinecolor (color)
  default: "#444"
  Sets the axis line color.
- outlinewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- bordercolor (color)
  default: "#444"
  Sets the axis line color.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) or the border enclosing this color bar.
- bgcolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of padded area.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  default: ""
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- title (string)
  default: "Click to enter colorscale title"
  Sets the title of the color bar.
- titlefont (named list)
  Sets this color bar's title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- titleside (enumerated: "right" | "top" | "bottom")
  default: "top"
  Determines the location of the colorbar title with respect to the color bar.
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
zsrc (string)
Sets the source reference on plot.ly for z .
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .

histogram

A histogram trace is initialized with plot_ly or add_trace:

plot_ly(df, type="histogram"[, ...])

                      add_trace(p, type="histogram"[, ...])

type ("histogram")
x (dataframe column, list, vector)
Sets the sample data to be binned on the x axis.
x0 (any)
default: 0
Alternate to `x`. Builds a linear space of x coordinates. Use with `dx` where `x0` is the starting coordinate and `dx` the step.
dx (number)
default: 1
Sets the x coordinate step. See `x0` for more info.
y (dataframe column, list, vector)
Sets the sample data to be binned on the y axis.
y0 (any)
default: 0
Alternate to `y`. Builds a linear space of y coordinates. Use with `dy` where `y0` is the starting coordinate and `dy` the step.
dy (number)
default: 1
Sets the y coordinate step. See `y0` for more info.
text (string)
default: ""
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates.
orientation (enumerated: "v" | "h")
Sets the orientation of the bars. With "v" ("h"), the value of the each bar spans along the vertical (horizontal).
marker (named list)
- color (dataframe column, list, vector)
  Sets the marker color.
- colorscale (colorscale)
  Has only an effect if `marker.color` is set to a numerical array. Sets the colorscale.
- cauto (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines the whether or not the color domain is computed automatically.
- cmax (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the upper bound of the color domain.
- cmin (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the lower bound of the color domain.
- autocolorscale (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not the colorscale is picked using values inside `marker.color`.
- reversescale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Reverses the colorscale.
- showscale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not a colorbar is displayed.
- line (named list)
  - color (color)
    Sets the color of the lines bounding the marker points.
  - colorscale (colorscale)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the colorscale.
  - cauto (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines the whether or not the color domain is computed with respect to the input data.
  - cmax (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the upper bound of the color domain.
  - cmin (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the lower bound of the color domain.
  - width (number greater than or equal to 0)
    Sets the width (in px) of the lines bounding the marker points.
  - autocolorscale (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines whether or not the colorscale is picked using the sign of values inside `marker.line.color`.
  - reversescale (boolean)
    Has only an effect if `marker.color.line` is set to a numerical array. Reverses the colorscale.
  - colorsrc (string)
    Sets the source reference on plot.ly for color .
  - widthsrc (string)
    Sets the source reference on plot.ly for width .
- colorbar (named list)
  - thicknessmode (enumerated: "fraction" | "pixels")
    default: "pixels"
    Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
  - thickness (number greater than or equal to 0)
    default: 30
    Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
  - lenmode (enumerated: "fraction" | "pixels")
    default: "fraction"
    Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
  - len (number greater than or equal to 0)
    default: 1
    Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
  - x (number)
    default: 1.02
    Sets the x position of the color bar (in plot fraction).
  - xanchor (enumerated: "left" | "center" | "right")
    default: "left"
    Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
  - xpad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the x direction.
  - y (number)
    default: 0.5
    Sets the y position of the color bar (in plot fraction).
  - yanchor (enumerated: "top" | "middle" | "bottom")
    default: "middle"
    Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
  - ypad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the y direction.
  - outlinecolor (color)
    default: "#444"
    Sets the axis line color.
  - outlinewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - bordercolor (color)
    default: "#444"
    Sets the axis line color.
  - borderwidth (number greater than or equal to 0)
    default: 0
    Sets the width (in px) or the border enclosing this color bar.
  - bgcolor (color)
    default: "rgba(0,0,0,0)"
    Sets the color of padded area.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    default: ""
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - title (string)
    default: "Click to enter colorscale title"
    Sets the title of the color bar.
  - titlefont (named list)
    Sets this color bar's title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - titleside (enumerated: "right" | "top" | "bottom")
    default: "top"
    Determines the location of the colorbar title with respect to the color bar.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
r (dataframe column, list, vector)
For polar chart only.Sets the radial coordinates.
t (dataframe column, list, vector)
For polar chart only.Sets the angular coordinates.
z (dataframe column, list, vector)
Sets the aggregation data.
histfunc (enumerated: "count" | "sum" | "avg" | "min" | "max")
default: "count"
Specifies the binning function used for this histogram trace. If "count", the histogram values are computed by counting the number of values lying inside each bin. If "sum", "avg", "min", "max", the histogram values are computed using the sum, the average, the minimum or the maximum of the values lying inside each bin respectively.
histnorm (enumerated: "" | "percent" | "probability" | "density" | "probability density")
default: ""
Specifies the type of normalization used for this histogram trace. If "", the span of each bar corresponds to the number of occurrences (i.e. the number of data points lying inside the bins). If "percent", the span of each bar corresponds to the percentage of occurrences with respect to the total number of sample points (here, the sum of all bin area equals 100%). If "density", the span of each bar corresponds to the number of occurrences in a bin divided by the size of the bin interval (here, the sum of all bin area equals the total number of sample points). If "probability density", the span of each bar corresponds to the probability that an event will fall into the corresponding bin (here, the sum of all bin area equals 1).
autobinx (boolean)
default: true
Determines whether or not the x axis bin attributes are picked by an algorithm.
nbinsx (integer greater than or equal to 0)
default: 0
Sets the number of x axis bins.
xbins (named list)
- start (number)
  Sets the starting value for the x axis bins.
- end (number)
  Sets the end value for the x axis bins.
- size (any)
  default: 1
  Sets the step in-between value each x axis bin.
autobiny (boolean)
default: true
Determines whether or not the y axis bin attributes are picked by an algorithm.
nbinsy (integer greater than or equal to 0)
default: 0
Sets the number of y axis bins.
ybins (named list)
- start (number)
  Sets the starting value for the y axis bins.
- end (number)
  Sets the end value for the y axis bins.
- size (any)
  default: 1
  Sets the step in-between value each y axis bin.
error_y (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
error_x (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
_deprecated
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .
rsrc (string)
Sets the source reference on plot.ly for r .
tsrc (string)
Sets the source reference on plot.ly for t .
zsrc (string)
Sets the source reference on plot.ly for z .

histogram2d

A histogram2d trace is initialized with plot_ly or add_trace:

plot_ly(df, type="histogram2d"[, ...])

                      add_trace(p, type="histogram2d"[, ...])

type ("histogram2d")
z (dataframe column, list, vector)
Sets the aggregation data.
x (dataframe column, list, vector)
Sets the sample data to be binned on the x axis.
x0 (any)
default: 0
Alternate to `x`. Builds a linear space of x coordinates. Use with `dx` where `x0` is the starting coordinate and `dx` the step.
dx (number)
default: 1
Sets the x coordinate step. See `x0` for more info.
y (dataframe column, list, vector)
Sets the sample data to be binned on the y axis.
y0 (any)
default: 0
Alternate to `y`. Builds a linear space of y coordinates. Use with `dy` where `y0` is the starting coordinate and `dy` the step.
dy (number)
default: 1
Sets the y coordinate step. See `y0` for more info.
text (dataframe column, list, vector)
Sets the text elements associated with each z value.
transpose (boolean)
Transposes the z data.
xtype (enumerated: "array" | "scaled")
If "array", the heatmap's x coordinates are given by "x" (the default behavior when `x` is provided). If "scaled", the heatmap's x coordinates are given by "x0" and "dx" (the default behavior when `x` is not provided).
ytype (enumerated: "array" | "scaled")
If "array", the heatmap's y coordinates are given by "y" (the default behavior when `y` is provided) If "scaled", the heatmap's y coordinates are given by "y0" and "dy" (the default behavior when `y` is not provided)
zauto (boolean)
default: true
Determines the whether or not the color domain is computed with respect to the input data.
zmin (number)
Sets the lower bound of color domain.
zmax (number)
Sets the upper bound of color domain.
colorscale (colorscale)
Sets the colorscale.
autocolorscale (boolean)
Determines whether or not the colorscale is picked using the sign of the input z values.
reversescale (boolean)
Reverses the colorscale.
showscale (boolean)
default: true
Determines whether or not a colorbar is displayed for this trace.
zsmooth (enumerated: "fast" | "best" | false)
Picks a smoothing algorithm use to smooth `z` data.
connectgaps (boolean)
Determines whether or not gaps (i.e. {nan} or missing values) in the `z` data are filled in.
colorbar (named list)
- thicknessmode (enumerated: "fraction" | "pixels")
  default: "pixels"
  Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
- thickness (number greater than or equal to 0)
  default: 30
  Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- lenmode (enumerated: "fraction" | "pixels")
  default: "fraction"
  Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
- len (number greater than or equal to 0)
  default: 1
  Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- x (number)
  default: 1.02
  Sets the x position of the color bar (in plot fraction).
- xanchor (enumerated: "left" | "center" | "right")
  default: "left"
  Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
- xpad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the x direction.
- y (number)
  default: 0.5
  Sets the y position of the color bar (in plot fraction).
- yanchor (enumerated: "top" | "middle" | "bottom")
  default: "middle"
  Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
- ypad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the y direction.
- outlinecolor (color)
  default: "#444"
  Sets the axis line color.
- outlinewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- bordercolor (color)
  default: "#444"
  Sets the axis line color.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) or the border enclosing this color bar.
- bgcolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of padded area.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  default: ""
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- title (string)
  default: "Click to enter colorscale title"
  Sets the title of the color bar.
- titlefont (named list)
  Sets this color bar's title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- titleside (enumerated: "right" | "top" | "bottom")
  default: "top"
  Determines the location of the colorbar title with respect to the color bar.
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
marker (named list)
- color (dataframe column, list, vector)
- colorsrc (string)
  Sets the source reference on plot.ly for color .
orientation (enumerated: "v" | "h")
Sets the orientation of the bars. With "v" ("h"), the value of the each bar spans along the vertical (horizontal).
histfunc (enumerated: "count" | "sum" | "avg" | "min" | "max")
default: "count"
Specifies the binning function used for this histogram trace. If "count", the histogram values are computed by counting the number of values lying inside each bin. If "sum", "avg", "min", "max", the histogram values are computed using the sum, the average, the minimum or the maximum of the values lying inside each bin respectively.
histnorm (enumerated: "" | "percent" | "probability" | "density" | "probability density")
default: ""
Specifies the type of normalization used for this histogram trace. If "", the span of each bar corresponds to the number of occurrences (i.e. the number of data points lying inside the bins). If "percent", the span of each bar corresponds to the percentage of occurrences with respect to the total number of sample points (here, the sum of all bin area equals 100%). If "density", the span of each bar corresponds to the number of occurrences in a bin divided by the size of the bin interval (here, the sum of all bin area equals the total number of sample points). If "probability density", the span of each bar corresponds to the probability that an event will fall into the corresponding bin (here, the sum of all bin area equals 1).
autobinx (boolean)
default: true
Determines whether or not the x axis bin attributes are picked by an algorithm.
nbinsx (integer greater than or equal to 0)
default: 0
Sets the number of x axis bins.
xbins (named list)
- start (number)
  Sets the starting value for the x axis bins.
- end (number)
  Sets the end value for the x axis bins.
- size (any)
  default: 1
  Sets the step in-between value each x axis bin.
autobiny (boolean)
default: true
Determines whether or not the y axis bin attributes are picked by an algorithm.
nbinsy (integer greater than or equal to 0)
default: 0
Sets the number of y axis bins.
ybins (named list)
- start (number)
  Sets the starting value for the y axis bins.
- end (number)
  Sets the end value for the y axis bins.
- size (any)
  default: 1
  Sets the step in-between value each y axis bin.
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
zsrc (string)
Sets the source reference on plot.ly for z .
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .

pie

A pie trace is initialized with plot_ly or add_trace:

plot_ly(df, type="pie"[, ...])

                      add_trace(p, type="pie"[, ...])

A pie trace accepts any of the keys listed below.

A data visualized by the sectors of the pie is set in `values`. The sector labels are set in `labels`. The sector colors are set in `marker.colors`

type ("pie")
labels (dataframe column, list, vector)
Sets the sector labels.
label0 (number)
default: 0
Alternate to `labels`. Builds a numeric set of labels. Use with `dlabel` where `label0` is the starting label and `dlabel` the step.
dlabel (number)
default: 1
Sets the label step. See `label0` for more info.
marker (named list)
- colors (dataframe column, list, vector)
  Sets the color of each sector of this pie chart. If not specified, the default trace color set is used to pick the sector colors.
- line (named list)
  - color (color)
    default: "#444"
    Sets the color of the line enclosing each sector.
  - width (number greater than or equal to 0)
    default: 0
    Sets the width (in px) of the line enclosing each sector.
  - colorsrc (string)
    Sets the source reference on plot.ly for color .
  - widthsrc (string)
    Sets the source reference on plot.ly for width .
- colorssrc (string)
  Sets the source reference on plot.ly for colors .
text (dataframe column, list, vector)
Sets text elements associated with each sector.
scalegroup (string)
default: ""
If there are multiple pies that should be sized according to their totals, link them by providing a non-empty group id here shared by every trace in the same group.
textinfo (flaglist)
flags: "label" | "text" | "value" | "percent"
extras: "none"
examples: "label", "text", "label+text", "label+text+value", "none"
Determines which trace information appear on the graph.
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
textposition (enumerated: "inside" | "outside" | "auto" | "none")
default: "auto"
Specifies the location of the `textinfo`.
textfont (named list)
Sets the font used for `textinfo`.
- family (string)
- size (number greater than or equal to 1)
- color (color)
insidetextfont (named list)
Sets the font used for `textinfo` lying inside the pie.
- family (string)
- size (number greater than or equal to 1)
- color (color)
outsidetextfont (named list)
Sets the font used for `textinfo` lying outside the pie.
- family (string)
- size (number greater than or equal to 1)
- color (color)
domain (named list)
- x (list)
  default: [0, 1]
  Sets the horizontal domain of this pie trace (in plot fraction).
- y (list)
  default: [0, 1]
  Sets the vertical domain of this pie trace (in plot fraction).
hole (number between or equal to 0 and 1)
default: 0
Sets the fraction of the radius to cut out of the pie. Use this to make a donut chart.
sort (boolean)
default: true
Determines whether or not the sectors of reordered from largest to smallest.
direction (enumerated: "clockwise" | "counterclockwise")
default: "counterclockwise"
Specifies the direction at which succeeding sectors follow one another.
rotation (number between or equal to -360 and 360)
default: 0
Instead of the first slice starting at 12 o'clock, rotate to some other angle.
pull (number between or equal to 0 and 1)
default: 0
Sets the fraction of larger radius to pull the sectors out from the center. This can be a constant to pull all slices apart from each other equally or an array to highlight one or more slices.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
labelssrc (string)
Sets the source reference on plot.ly for labels .
valuessrc (string)
Sets the source reference on plot.ly for values .
textsrc (string)
Sets the source reference on plot.ly for text .
textpositionsrc (string)
Sets the source reference on plot.ly for textposition .
pullsrc (string)
Sets the source reference on plot.ly for pull .

contour

A contour trace is initialized with plot_ly or add_trace:

plot_ly(df, type="contour"[, ...])

                      add_trace(p, type="contour"[, ...])

type ("contour")
z (dataframe column, list, vector)
Sets the z data.
x (dataframe column, list, vector)
Sets the x coordinates.
x0 (any)
default: 0
Alternate to `x`. Builds a linear space of x coordinates. Use with `dx` where `x0` is the starting coordinate and `dx` the step.
dx (number)
default: 1
Sets the x coordinate step. See `x0` for more info.
y (dataframe column, list, vector)
Sets the y coordinates.
y0 (any)
default: 0
Alternate to `y`. Builds a linear space of y coordinates. Use with `dy` where `y0` is the starting coordinate and `dy` the step.
dy (number)
default: 1
Sets the y coordinate step. See `y0` for more info.
text (dataframe column, list, vector)
Sets the text elements associated with each z value.
transpose (boolean)
Transposes the z data.
xtype (enumerated: "array" | "scaled")
If "array", the heatmap's x coordinates are given by "x" (the default behavior when `x` is provided). If "scaled", the heatmap's x coordinates are given by "x0" and "dx" (the default behavior when `x` is not provided).
ytype (enumerated: "array" | "scaled")
If "array", the heatmap's y coordinates are given by "y" (the default behavior when `y` is provided) If "scaled", the heatmap's y coordinates are given by "y0" and "dy" (the default behavior when `y` is not provided)
zauto (boolean)
default: true
Determines the whether or not the color domain is computed with respect to the input data.
zmin (number)
Sets the lower bound of color domain.
zmax (number)
Sets the upper bound of color domain.
colorscale (colorscale)
Sets the colorscale.
autocolorscale (boolean)
Determines whether or not the colorscale is picked using the sign of the input z values.
reversescale (boolean)
Reverses the colorscale.
showscale (boolean)
default: true
Determines whether or not a colorbar is displayed for this trace.
zsmooth (enumerated: "fast" | "best" | false)
Picks a smoothing algorithm use to smooth `z` data.
connectgaps (boolean)
Determines whether or not gaps (i.e. {nan} or missing values) in the `z` data are filled in.
colorbar (named list)
- thicknessmode (enumerated: "fraction" | "pixels")
  default: "pixels"
  Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
- thickness (number greater than or equal to 0)
  default: 30
  Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- lenmode (enumerated: "fraction" | "pixels")
  default: "fraction"
  Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
- len (number greater than or equal to 0)
  default: 1
  Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- x (number)
  default: 1.02
  Sets the x position of the color bar (in plot fraction).
- xanchor (enumerated: "left" | "center" | "right")
  default: "left"
  Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
- xpad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the x direction.
- y (number)
  default: 0.5
  Sets the y position of the color bar (in plot fraction).
- yanchor (enumerated: "top" | "middle" | "bottom")
  default: "middle"
  Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
- ypad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the y direction.
- outlinecolor (color)
  default: "#444"
  Sets the axis line color.
- outlinewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- bordercolor (color)
  default: "#444"
  Sets the axis line color.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) or the border enclosing this color bar.
- bgcolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of padded area.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  default: ""
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- title (string)
  default: "Click to enter colorscale title"
  Sets the title of the color bar.
- titlefont (named list)
  Sets this color bar's title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- titleside (enumerated: "right" | "top" | "bottom")
  default: "top"
  Determines the location of the colorbar title with respect to the color bar.
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
autocontour (boolean)
default: true
Determines whether of not the contour level attributes at picked by an algorithm. If "true", the number of contour levels can be set in `ncontours`. If "false", set the contour level attributes in `contours`.
ncontours (integer)
default: 0
Sets the number of contour levels.
contours (named list)
- start (number)
  Sets the starting contour level value.
- end (number)
  Sets the end contour level value.
- size (number)
  Sets the step between each contour level.
- coloring (enumerated: "fill" | "heatmap" | "lines" | "none")
  default: "fill"
  Determines the coloring method showing the contour values. If "fill", coloring is done evenly between each contour level If "heatmap", a heatmap gradient is coloring is applied between each contour level. If "lines", coloring is done on the contour lines. If "none", no coloring is applied on this trace.
- showlines (boolean)
  default: true
  Determines whether or not the contour lines are drawn. Has only an effect if `contours.coloring` is set to "fill".
line (named list)
- color (color)
  Sets the color of the contour level. Has no if `contours.coloring` is set to "lines".
- width (number greater than or equal to 0)
  default: 2
  Sets the line width (in px).
- dash (string)
  default: "solid"
  Sets the style of the lines.
- smoothing (number between or equal to 0 and 1.3)
  default: 1
  Sets the amount of smoothing for the contour lines, where "0" corresponds to no smoothing.
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
zsrc (string)
Sets the source reference on plot.ly for z .
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .

histogram2dcontour

A histogram2dcontour trace is initialized with plot_ly or add_trace:

plot_ly(df, type="histogram2dcontour"[, ...])

                      add_trace(p, type="histogram2dcontour"[, ...])

type ("histogram2dcontour")
z (dataframe column, list, vector)
Sets the aggregation data.
x (dataframe column, list, vector)
Sets the sample data to be binned on the x axis.
x0 (any)
default: 0
Alternate to `x`. Builds a linear space of x coordinates. Use with `dx` where `x0` is the starting coordinate and `dx` the step.
dx (number)
default: 1
Sets the x coordinate step. See `x0` for more info.
y (dataframe column, list, vector)
Sets the sample data to be binned on the y axis.
y0 (any)
default: 0
Alternate to `y`. Builds a linear space of y coordinates. Use with `dy` where `y0` is the starting coordinate and `dy` the step.
dy (number)
default: 1
Sets the y coordinate step. See `y0` for more info.
text (dataframe column, list, vector)
Sets the text elements associated with each z value.
transpose (boolean)
Transposes the z data.
xtype (enumerated: "array" | "scaled")
If "array", the heatmap's x coordinates are given by "x" (the default behavior when `x` is provided). If "scaled", the heatmap's x coordinates are given by "x0" and "dx" (the default behavior when `x` is not provided).
ytype (enumerated: "array" | "scaled")
If "array", the heatmap's y coordinates are given by "y" (the default behavior when `y` is provided) If "scaled", the heatmap's y coordinates are given by "y0" and "dy" (the default behavior when `y` is not provided)
zauto (boolean)
default: true
Determines the whether or not the color domain is computed with respect to the input data.
zmin (number)
Sets the lower bound of color domain.
zmax (number)
Sets the upper bound of color domain.
colorscale (colorscale)
Sets the colorscale.
autocolorscale (boolean)
Determines whether or not the colorscale is picked using the sign of the input z values.
reversescale (boolean)
Reverses the colorscale.
showscale (boolean)
default: true
Determines whether or not a colorbar is displayed for this trace.
zsmooth (enumerated: "fast" | "best" | false)
Picks a smoothing algorithm use to smooth `z` data.
connectgaps (boolean)
Determines whether or not gaps (i.e. {nan} or missing values) in the `z` data are filled in.
colorbar (named list)
- thicknessmode (enumerated: "fraction" | "pixels")
  default: "pixels"
  Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
- thickness (number greater than or equal to 0)
  default: 30
  Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- lenmode (enumerated: "fraction" | "pixels")
  default: "fraction"
  Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
- len (number greater than or equal to 0)
  default: 1
  Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- x (number)
  default: 1.02
  Sets the x position of the color bar (in plot fraction).
- xanchor (enumerated: "left" | "center" | "right")
  default: "left"
  Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
- xpad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the x direction.
- y (number)
  default: 0.5
  Sets the y position of the color bar (in plot fraction).
- yanchor (enumerated: "top" | "middle" | "bottom")
  default: "middle"
  Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
- ypad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the y direction.
- outlinecolor (color)
  default: "#444"
  Sets the axis line color.
- outlinewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- bordercolor (color)
  default: "#444"
  Sets the axis line color.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) or the border enclosing this color bar.
- bgcolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of padded area.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  default: ""
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- title (string)
  default: "Click to enter colorscale title"
  Sets the title of the color bar.
- titlefont (named list)
  Sets this color bar's title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- titleside (enumerated: "right" | "top" | "bottom")
  default: "top"
  Determines the location of the colorbar title with respect to the color bar.
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
marker (named list)
- color (dataframe column, list, vector)
- colorsrc (string)
  Sets the source reference on plot.ly for color .
orientation (enumerated: "v" | "h")
Sets the orientation of the bars. With "v" ("h"), the value of the each bar spans along the vertical (horizontal).
histfunc (enumerated: "count" | "sum" | "avg" | "min" | "max")
default: "count"
Specifies the binning function used for this histogram trace. If "count", the histogram values are computed by counting the number of values lying inside each bin. If "sum", "avg", "min", "max", the histogram values are computed using the sum, the average, the minimum or the maximum of the values lying inside each bin respectively.
histnorm (enumerated: "" | "percent" | "probability" | "density" | "probability density")
default: ""
Specifies the type of normalization used for this histogram trace. If "", the span of each bar corresponds to the number of occurrences (i.e. the number of data points lying inside the bins). If "percent", the span of each bar corresponds to the percentage of occurrences with respect to the total number of sample points (here, the sum of all bin area equals 100%). If "density", the span of each bar corresponds to the number of occurrences in a bin divided by the size of the bin interval (here, the sum of all bin area equals the total number of sample points). If "probability density", the span of each bar corresponds to the probability that an event will fall into the corresponding bin (here, the sum of all bin area equals 1).
autobinx (boolean)
default: true
Determines whether or not the x axis bin attributes are picked by an algorithm.
nbinsx (integer greater than or equal to 0)
default: 0
Sets the number of x axis bins.
xbins (named list)
- start (number)
  Sets the starting value for the x axis bins.
- end (number)
  Sets the end value for the x axis bins.
- size (any)
  default: 1
  Sets the step in-between value each x axis bin.
autobiny (boolean)
default: true
Determines whether or not the y axis bin attributes are picked by an algorithm.
nbinsy (integer greater than or equal to 0)
default: 0
Sets the number of y axis bins.
ybins (named list)
- start (number)
  Sets the starting value for the y axis bins.
- end (number)
  Sets the end value for the y axis bins.
- size (any)
  default: 1
  Sets the step in-between value each y axis bin.
autocontour (boolean)
default: true
Determines whether of not the contour level attributes at picked by an algorithm. If "true", the number of contour levels can be set in `ncontours`. If "false", set the contour level attributes in `contours`.
ncontours (integer)
default: 0
Sets the number of contour levels.
contours (named list)
- start (number)
  Sets the starting contour level value.
- end (number)
  Sets the end contour level value.
- size (number)
  Sets the step between each contour level.
- coloring (enumerated: "fill" | "heatmap" | "lines" | "none")
  default: "fill"
  Determines the coloring method showing the contour values. If "fill", coloring is done evenly between each contour level If "heatmap", a heatmap gradient is coloring is applied between each contour level. If "lines", coloring is done on the contour lines. If "none", no coloring is applied on this trace.
- showlines (boolean)
  default: true
  Determines whether or not the contour lines are drawn. Has only an effect if `contours.coloring` is set to "fill".
line (named list)
- color (color)
  Sets the color of the contour level. Has no if `contours.coloring` is set to "lines".
- width (number greater than or equal to 0)
  default: 2
  Sets the line width (in px).
- dash (string)
  default: "solid"
  Sets the style of the lines.
- smoothing (number between or equal to 0 and 1.3)
  default: 1
  Sets the amount of smoothing for the contour lines, where "0" corresponds to no smoothing.
xaxis (axisid)
default: x
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on.
yaxis (axisid)
default: y
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the y coordinates refer to `layout.yaxis`. If "y2", the y coordinates refer to `layout.xaxis2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
zsrc (string)
Sets the source reference on plot.ly for z .
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .

scatter3d

A scatter3d trace is initialized with plot_ly or add_trace:

plot_ly(df, type="scatter3d"[, ...])

                      add_trace(p, type="scatter3d"[, ...])

type ("scatter3d")
x (dataframe column, list, vector)
Sets the x coordinates.
y (dataframe column, list, vector)
Sets the y coordinates.
z (dataframe column, list, vector)
Sets the z coordinates.
text (string)
default: ""
Sets text elements associated with each (x,y,z) triplet. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y,z) coordinates.
mode (flaglist)
flags: "lines" | "markers" | "text"
default: lines+markers
extras: "none"
examples: "lines", "markers", "lines+markers", "lines+markers+text", "none"
Determines the drawing mode for this scatter trace. If the provided `mode` includes "text" then the `text` elements appear at the coordinates. Otherwise, the `text` elements appear on hover.
surfaceaxis (enumerated: "-1" | "0" | "1" | "2")
default: "-1"
If "-1", the scatter points are not fill with a surface If "0", "1", "2", the scatter points are filled with a Delaunay surface about the x, y, z respectively.
surfacecolor (color)
Sets the surface fill color.
projection (named list)
- x (named list)
  - show (boolean)
    Sets whether or not projections are shown along the x axis.
  - opacity (number between or equal to 0 and 1)
    default: 1
    Sets the projection color.
  - scale (number between or equal to 0 and 10)
    default: 0.6666666666666666
    Sets the scale factor determining the size of the projection marker points.
- y (named list)
  - show (boolean)
    Sets whether or not projections are shown along the y axis.
  - opacity (number between or equal to 0 and 1)
    default: 1
    Sets the projection color.
  - scale (number between or equal to 0 and 10)
    default: 0.6666666666666666
    Sets the scale factor determining the size of the projection marker points.
- z (named list)
  - show (boolean)
    Sets whether or not projections are shown along the z axis.
  - opacity (number between or equal to 0 and 1)
    default: 1
    Sets the projection color.
  - scale (number between or equal to 0 and 10)
    default: 0.6666666666666666
    Sets the scale factor determining the size of the projection marker points.
line (named list)
- color (color)
  Sets the line color.
- width (number greater than or equal to 0)
  default: 2
  Sets the line width (in px).
- dash (string)
  default: "solid"
  Sets the style of the lines.
marker (named list)
- color (color)
  Sets the marker color.
- symbol (enumerated: "circle" | "circle-open" | "square" | "square-open" | "diamond" | "diamond-open" | "cross" | "x")
  default: "circle"
  Sets the marker symbol type.
- size (number greater than or equal to 0)
  default: 8
  Sets the marker size (in px).
- sizeref (number)
  default: 1
  Has only an effect if `marker.size` is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with `sizemin` and `sizemode`.
- sizemin (number greater than or equal to 0)
  default: 0
  Has only an effect if `marker.size` is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
- sizemode (enumerated: "diameter" | "area")
  default: "diameter"
  Has only an effect if `marker.size` is set to a numerical array. Sets the rule for which the data in `size` is converted to pixels.
- opacity (number between or equal to 0 and 1)
  Sets the marker opacity.
- colorscale (colorscale)
  Has only an effect if `marker.color` is set to a numerical array. Sets the colorscale.
- cauto (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines the whether or not the color domain is computed automatically.
- cmax (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the upper bound of the color domain.
- cmin (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the lower bound of the color domain.
- autocolorscale (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not the colorscale is picked using values inside `marker.color`.
- reversescale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Reverses the colorscale.
- showscale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not a colorbar is displayed.
- line (named list)
  - color (color)
    Sets the color of the lines bounding the marker points.
  - width (number greater than or equal to 0)
    Sets the width (in px) of the lines bounding the marker points.
  - colorscale (colorscale)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the colorscale.
  - cauto (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines the whether or not the color domain is computed with respect to the input data.
  - cmax (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the upper bound of the color domain.
  - cmin (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the lower bound of the color domain.
  - autocolorscale (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines whether or not the colorscale is picked using the sign of values inside `marker.line.color`.
  - reversescale (boolean)
    Has only an effect if `marker.color.line` is set to a numerical array. Reverses the colorscale.
  - colorsrc (string)
    Sets the source reference on plot.ly for color .
- colorbar (named list)
  - thicknessmode (enumerated: "fraction" | "pixels")
    default: "pixels"
    Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
  - thickness (number greater than or equal to 0)
    default: 30
    Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
  - lenmode (enumerated: "fraction" | "pixels")
    default: "fraction"
    Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
  - len (number greater than or equal to 0)
    default: 1
    Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
  - x (number)
    default: 1.02
    Sets the x position of the color bar (in plot fraction).
  - xanchor (enumerated: "left" | "center" | "right")
    default: "left"
    Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
  - xpad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the x direction.
  - y (number)
    default: 0.5
    Sets the y position of the color bar (in plot fraction).
  - yanchor (enumerated: "top" | "middle" | "bottom")
    default: "middle"
    Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
  - ypad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the y direction.
  - outlinecolor (color)
    default: "#444"
    Sets the axis line color.
  - outlinewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - bordercolor (color)
    default: "#444"
    Sets the axis line color.
  - borderwidth (number greater than or equal to 0)
    default: 0
    Sets the width (in px) or the border enclosing this color bar.
  - bgcolor (color)
    default: "rgba(0,0,0,0)"
    Sets the color of padded area.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    default: ""
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - title (string)
    default: "Click to enter colorscale title"
    Sets the title of the color bar.
  - titlefont (named list)
    Sets this color bar's title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - titleside (enumerated: "right" | "top" | "bottom")
    default: "top"
    Determines the location of the colorbar title with respect to the color bar.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
- symbolsrc (string)
  Sets the source reference on plot.ly for symbol .
- sizesrc (string)
  Sets the source reference on plot.ly for size .
- opacitysrc (string)
  Sets the source reference on plot.ly for opacity .
textposition (enumerated: "top left" | "top center" | "top right" | "middle left" | "middle center" | "middle right" | "bottom left" | "bottom center" | "bottom right")
default: "top center"
Sets the positions of the `text` elements with respects to the (x,y) coordinates.
textfont (named list)
Sets the text font.
- family (string)
- size (number greater than or equal to 1)
- color (color)
- familysrc (string)
  Sets the source reference on plot.ly for family .
- sizesrc (string)
  Sets the source reference on plot.ly for size .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
error_x (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
error_y (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
error_z (named list)
- visible (boolean)
  Determines whether or not this set of error bars is visible.
- type (enumerated: "percent" | "constant" | "sqrt" | "data")
  Determines the rule used to generate the error bars. If "constant`, the bar lengths are of a constant value. Set this constant in `value`. If "percent", the bar lengths correspond to a percentage of underlying data. Set this percentage in `value`. If "sqrt", the bar lengths correspond to the sqaure of the underlying data. If "array", the bar lengths are set with data set `array`.
- symmetric (boolean)
  Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
- array (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
- arrayminus (dataframe column, list, vector)
  Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
- value (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars.
- valueminus (number greater than or equal to 0)
  default: 10
  Sets the value of either the percentage (if `type` is set to "percent") or the constant (if `type` is set to "constant") corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
- traceref (integer greater than or equal to 0)
  default: 0
- tracerefminus (integer greater than or equal to 0)
  default: 0
- copy_ystyle (boolean)
- copy_zstyle (boolean)
- color (color)
  Sets the stoke color of the error bars.
- thickness (number greater than or equal to 0)
  default: 2
  Sets the thickness (in px) of the error bars.
- width (number greater than or equal to 0)
  Sets the width (in px) of the cross-bar at both ends of the error bars.
- _deprecated
- arraysrc (string)
  Sets the source reference on plot.ly for array .
- arrayminussrc (string)
  Sets the source reference on plot.ly for arrayminus .
scene (sceneid)
default: scene
Sets a reference between this trace's 3D coordinate system and a 3D scene. If "scene" (the default value), the (x,y,z) coordinates refer to `layout.scene`. If "scene2", the (x,y,z) coordinates refer to `layout.scene2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
zsrc (string)
Sets the source reference on plot.ly for z .
textsrc (string)
Sets the source reference on plot.ly for text .
textpositionsrc (string)
Sets the source reference on plot.ly for textposition .

surface

A surface trace is initialized with plot_ly or add_trace:

plot_ly(df, type="surface"[, ...])

                      add_trace(p, type="surface"[, ...])

type ("surface")
z (dataframe column, list, vector)
Sets the z coordinates.
x (dataframe column, list, vector)
Sets the x coordinates.
y (dataframe column, list, vector)
Sets the y coordinates.
text (dataframe column, list, vector)
Sets the text elements associated with each z value.
zauto (boolean)
default: true
Determines the whether or not the color domain is computed with respect to the input data.
zmin (number)
Sets the lower bound of color domain.
zmax (number)
Sets the upper bound of color domain.
colorscale (colorscale)
Sets the colorscale.
autocolorscale (boolean)
Determines whether or not the colorscale is picked using the sign of the input z values.
reversescale (boolean)
Reverses the colorscale.
showscale (boolean)
default: true
Determines whether or not a colorbar is displayed for this trace.
contours (named list)
- x (named list)
  - show (boolean)
    Sets whether or not dynamic contours are shown along the x axis
  - project (named list)
    - x (boolean)
      Sets whether or not the dynamic contours are projected along the x axis.
    - y (boolean)
      Sets whether or not the dynamic contours are projected along the y axis.
    - z (boolean)
      Sets whether or not the dynamic contours are projected along the z axis.
  - color (color)
    default: "#000"
  - usecolormap (boolean)
  - width (number between or equal to 1 and 16)
    default: 2
  - highlight (boolean)
  - highlightColor (color)
    default: "#000"
  - highlightWidth (number between or equal to 1 and 16)
    default: 2
- y (named list)
  - show (boolean)
    Sets whether or not dynamic contours are shown along the y axis
  - project (named list)
    - x (boolean)
      Sets whether or not the dynamic contours are projected along the x axis.
    - y (boolean)
      Sets whether or not the dynamic contours are projected along the y axis.
    - z (boolean)
      Sets whether or not the dynamic contours are projected along the z axis.
  - color (color)
    default: "#000"
  - usecolormap (boolean)
  - width (number between or equal to 1 and 16)
    default: 2
  - highlight (boolean)
  - highlightColor (color)
    default: "#000"
  - highlightWidth (number between or equal to 1 and 16)
    default: 2
- z (named list)
  - show (boolean)
    Sets whether or not dynamic contours are shown along the z axis
  - project (named list)
    - x (boolean)
      Sets whether or not the dynamic contours are projected along the x axis.
    - y (boolean)
      Sets whether or not the dynamic contours are projected along the y axis.
    - z (boolean)
      Sets whether or not the dynamic contours are projected along the z axis.
  - color (color)
    default: "#000"
  - usecolormap (boolean)
  - width (number between or equal to 1 and 16)
    default: 2
  - highlight (boolean)
  - highlightColor (color)
    default: "#000"
  - highlightWidth (number between or equal to 1 and 16)
    default: 2
hidesurface (boolean)
lighting (named list)
- ambient (number between or equal to 0 and 1)
  default: 0.8
- diffuse (number between or equal to 0 and 1)
  default: 0.8
- specular (number between or equal to 0 and 2)
  default: 0.05
- roughness (number between or equal to 0 and 1)
  default: 0.5
- fresnel (number between or equal to 0 and 5)
  default: 0.2
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
colorbar (named list)
- thicknessmode (enumerated: "fraction" | "pixels")
  default: "pixels"
  Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
- thickness (number greater than or equal to 0)
  default: 30
  Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- lenmode (enumerated: "fraction" | "pixels")
  default: "fraction"
  Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
- len (number greater than or equal to 0)
  default: 1
  Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- x (number)
  default: 1.02
  Sets the x position of the color bar (in plot fraction).
- xanchor (enumerated: "left" | "center" | "right")
  default: "left"
  Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
- xpad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the x direction.
- y (number)
  default: 0.5
  Sets the y position of the color bar (in plot fraction).
- yanchor (enumerated: "top" | "middle" | "bottom")
  default: "middle"
  Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
- ypad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the y direction.
- outlinecolor (color)
  default: "#444"
  Sets the axis line color.
- outlinewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- bordercolor (color)
  default: "#444"
  Sets the axis line color.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) or the border enclosing this color bar.
- bgcolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of padded area.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  default: ""
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- title (string)
  default: "Click to enter colorscale title"
  Sets the title of the color bar.
- titlefont (named list)
  Sets this color bar's title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- titleside (enumerated: "right" | "top" | "bottom")
  default: "top"
  Determines the location of the colorbar title with respect to the color bar.
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
scene (sceneid)
default: scene
Sets a reference between this trace's 3D coordinate system and a 3D scene. If "scene" (the default value), the (x,y,z) coordinates refer to `layout.scene`. If "scene2", the (x,y,z) coordinates refer to `layout.scene2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
zsrc (string)
Sets the source reference on plot.ly for z .
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
textsrc (string)
Sets the source reference on plot.ly for text .

mesh3d

A mesh3d trace is initialized with plot_ly or add_trace:

plot_ly(df, type="mesh3d"[, ...])

                      add_trace(p, type="mesh3d"[, ...])

A mesh3d trace accepts any of the keys listed below.

type ("mesh3d")
x (dataframe column, list, vector)
y (dataframe column, list, vector)
z (dataframe column, list, vector)
i (dataframe column, list, vector)
j (dataframe column, list, vector)
k (dataframe column, list, vector)
delaunayaxis (enumerated: "x" | "y" | "z")
default: "z"
alphahull (number)
default: -1
intensity (dataframe column, list, vector)
color (color)
vertexcolor (dataframe column, list, vector)
facecolor (dataframe column, list, vector)
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
flatshading (boolean)
contour (named list)
- show (boolean)
- color (color)
  default: "#000"
- width (number between or equal to 1 and 16)
  default: 2
colorscale (colorscale)
Sets the colorscale.
reversescale (boolean)
Reverses the colorscale.
showscale (boolean)
default: true
Determines whether or not a colorbar is displayed for this trace.
lighting (named list)
- ambient (number between or equal to 0 and 1)
  default: 0.8
- diffuse (number between or equal to 0 and 1)
  default: 0.8
- specular (number between or equal to 0 and 2)
  default: 0.05
- roughness (number between or equal to 0 and 1)
  default: 0.5
- fresnel (number between or equal to 0 and 5)
  default: 0.2
colorbar (named list)
- thicknessmode (enumerated: "fraction" | "pixels")
  default: "pixels"
  Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
- thickness (number greater than or equal to 0)
  default: 30
  Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- lenmode (enumerated: "fraction" | "pixels")
  default: "fraction"
  Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
- len (number greater than or equal to 0)
  default: 1
  Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- x (number)
  default: 1.02
  Sets the x position of the color bar (in plot fraction).
- xanchor (enumerated: "left" | "center" | "right")
  default: "left"
  Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
- xpad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the x direction.
- y (number)
  default: 0.5
  Sets the y position of the color bar (in plot fraction).
- yanchor (enumerated: "top" | "middle" | "bottom")
  default: "middle"
  Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
- ypad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the y direction.
- outlinecolor (color)
  default: "#444"
  Sets the axis line color.
- outlinewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- bordercolor (color)
  default: "#444"
  Sets the axis line color.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) or the border enclosing this color bar.
- bgcolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of padded area.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  default: ""
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- title (string)
  default: "Click to enter colorscale title"
  Sets the title of the color bar.
- titlefont (named list)
  Sets this color bar's title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- titleside (enumerated: "right" | "top" | "bottom")
  default: "top"
  Determines the location of the colorbar title with respect to the color bar.
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
scene (sceneid)
default: scene
Sets a reference between this trace's 3D coordinate system and a 3D scene. If "scene" (the default value), the (x,y,z) coordinates refer to `layout.scene`. If "scene2", the (x,y,z) coordinates refer to `layout.scene2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
xsrc (string)
Sets the source reference on plot.ly for x .
ysrc (string)
Sets the source reference on plot.ly for y .
zsrc (string)
Sets the source reference on plot.ly for z .
isrc (string)
Sets the source reference on plot.ly for i .
jsrc (string)
Sets the source reference on plot.ly for j .
ksrc (string)
Sets the source reference on plot.ly for k .
intensitysrc (string)
Sets the source reference on plot.ly for intensity .
vertexcolorsrc (string)
Sets the source reference on plot.ly for vertexcolor .
facecolorsrc (string)
Sets the source reference on plot.ly for facecolor .

scattergeo

A scattergeo trace is initialized with plot_ly or add_trace:

plot_ly(df, type="scattergeo"[, ...])

                      add_trace(p, type="scattergeo"[, ...])

type ("scattergeo")
lon (dataframe column, list, vector)
Sets the longitude coordinates (in degrees East).
lat (dataframe column, list, vector)
Sets the latitude coordinates (in degrees North).
locations (dataframe column, list, vector)
Sets the coordinates via location IDs or names. Coordinates correspond to the centroid of each location given. See `locationmode` for more info.
locationmode (enumerated: "ISO-3" | "USA-states" | "country names")
default: "ISO-3"
Determines the set of locations used to match entries in `locations` to regions on the map.
mode (flaglist)
flags: "lines" | "markers" | "text"
default: markers
extras: "none"
examples: "lines", "markers", "lines+markers", "lines+markers+text", "none"
Determines the drawing mode for this scatter trace. If the provided `mode` includes "text" then the `text` elements appear at the coordinates. Otherwise, the `text` elements appear on hover.
text (string)
default: ""
Sets text elements associated with each (lon,lat) pair. or item in `locations`. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (lon,lat) or `locations` coordinates.
line (named list)
- color (color)
  Sets the line color.
- width (number greater than or equal to 0)
  default: 2
  Sets the line width (in px).
- dash (string)
  default: "solid"
  Sets the style of the lines.
marker (named list)
- symbol (enumerated: "0" | "circle" | "100" | "circle-open" | "200" | "circle-dot" | "300" | "circle-open-dot" | "1" | "square" | "101" | "square-open" | "201" | "square-dot" | "301" | "square-open-dot" | "2" | "diamond" | "102" | "diamond-open" | "202" | "diamond-dot" | "302" | "diamond-open-dot" | "3" | "cross" | "103" | "cross-open" | "203" | "cross-dot" | "303" | "cross-open-dot" | "4" | "x" | "104" | "x-open" | "204" | "x-dot" | "304" | "x-open-dot" | "5" | "triangle-up" | "105" | "triangle-up-open" | "205" | "triangle-up-dot" | "305" | "triangle-up-open-dot" | "6" | "triangle-down" | "106" | "triangle-down-open" | "206" | "triangle-down-dot" | "306" | "triangle-down-open-dot" | "7" | "triangle-left" | "107" | "triangle-left-open" | "207" | "triangle-left-dot" | "307" | "triangle-left-open-dot" | "8" | "triangle-right" | "108" | "triangle-right-open" | "208" | "triangle-right-dot" | "308" | "triangle-right-open-dot" | "9" | "triangle-ne" | "109" | "triangle-ne-open" | "209" | "triangle-ne-dot" | "309" | "triangle-ne-open-dot" | "10" | "triangle-se" | "110" | "triangle-se-open" | "210" | "triangle-se-dot" | "310" | "triangle-se-open-dot" | "11" | "triangle-sw" | "111" | "triangle-sw-open" | "211" | "triangle-sw-dot" | "311" | "triangle-sw-open-dot" | "12" | "triangle-nw" | "112" | "triangle-nw-open" | "212" | "triangle-nw-dot" | "312" | "triangle-nw-open-dot" | "13" | "pentagon" | "113" | "pentagon-open" | "213" | "pentagon-dot" | "313" | "pentagon-open-dot" | "14" | "hexagon" | "114" | "hexagon-open" | "214" | "hexagon-dot" | "314" | "hexagon-open-dot" | "15" | "hexagon2" | "115" | "hexagon2-open" | "215" | "hexagon2-dot" | "315" | "hexagon2-open-dot" | "16" | "octagon" | "116" | "octagon-open" | "216" | "octagon-dot" | "316" | "octagon-open-dot" | "17" | "star" | "117" | "star-open" | "217" | "star-dot" | "317" | "star-open-dot" | "18" | "hexagram" | "118" | "hexagram-open" | "218" | "hexagram-dot" | "318" | "hexagram-open-dot" | "19" | "star-triangle-up" | "119" | "star-triangle-up-open" | "219" | "star-triangle-up-dot" | "319" | "star-triangle-up-open-dot" | "20" | "star-triangle-down" | "120" | "star-triangle-down-open" | "220" | "star-triangle-down-dot" | "320" | "star-triangle-down-open-dot" | "21" | "star-square" | "121" | "star-square-open" | "221" | "star-square-dot" | "321" | "star-square-open-dot" | "22" | "star-diamond" | "122" | "star-diamond-open" | "222" | "star-diamond-dot" | "322" | "star-diamond-open-dot" | "23" | "diamond-tall" | "123" | "diamond-tall-open" | "223" | "diamond-tall-dot" | "323" | "diamond-tall-open-dot" | "24" | "diamond-wide" | "124" | "diamond-wide-open" | "224" | "diamond-wide-dot" | "324" | "diamond-wide-open-dot" | "25" | "hourglass" | "125" | "hourglass-open" | "26" | "bowtie" | "126" | "bowtie-open" | "27" | "circle-cross" | "127" | "circle-cross-open" | "28" | "circle-x" | "128" | "circle-x-open" | "29" | "square-cross" | "129" | "square-cross-open" | "30" | "square-x" | "130" | "square-x-open" | "31" | "diamond-cross" | "131" | "diamond-cross-open" | "32" | "diamond-x" | "132" | "diamond-x-open" | "33" | "cross-thin" | "133" | "cross-thin-open" | "34" | "x-thin" | "134" | "x-thin-open" | "35" | "asterisk" | "135" | "asterisk-open" | "36" | "hash" | "136" | "hash-open" | "236" | "hash-dot" | "336" | "hash-open-dot" | "37" | "y-up" | "137" | "y-up-open" | "38" | "y-down" | "138" | "y-down-open" | "39" | "y-left" | "139" | "y-left-open" | "40" | "y-right" | "140" | "y-right-open" | "41" | "line-ew" | "141" | "line-ew-open" | "42" | "line-ns" | "142" | "line-ns-open" | "43" | "line-ne" | "143" | "line-ne-open" | "44" | "line-nw" | "144" | "line-nw-open")
  default: "circle"
  Sets the marker symbol type. Adding 100 is equivalent to appending "-open" to a symbol name. Adding 200 is equivalent to appending "-dot" to a symbol name. Adding 300 is equivalent to appending "-open-dot" or "dot-open" to a symbol name.
- opacity (number between or equal to 0 and 1)
  Sets the marker opacity.
- size (number greater than or equal to 0)
  default: 6
  Sets the marker size (in px).
- sizeref (number)
  default: 1
  Has only an effect if `marker.size` is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with `sizemin` and `sizemode`.
- sizemin (number greater than or equal to 0)
  default: 0
  Has only an effect if `marker.size` is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
- sizemode (enumerated: "diameter" | "area")
  default: "diameter"
  Has only an effect if `marker.size` is set to a numerical array. Sets the rule for which the data in `size` is converted to pixels.
- color (color)
  Sets the marker color.
- colorscale (colorscale)
  Has only an effect if `marker.color` is set to a numerical array. Sets the colorscale.
- cauto (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines the whether or not the color domain is computed automatically.
- cmax (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the upper bound of the color domain.
- cmin (number)
  Has only an effect if `marker.color` is set to a numerical array. Sets the lower bound of the color domain.
- autocolorscale (boolean)
  default: true
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not the colorscale is picked using values inside `marker.color`.
- reversescale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Reverses the colorscale.
- showscale (boolean)
  Has only an effect if `marker.color` is set to a numerical array. Determines whether or not a colorbar is displayed.
- line (named list)
  - color (color)
    Sets the color of the lines bounding the marker points.
  - width (number greater than or equal to 0)
    Sets the width (in px) of the lines bounding the marker points.
  - colorscale (colorscale)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the colorscale.
  - cauto (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines the whether or not the color domain is computed with respect to the input data.
  - cmax (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the upper bound of the color domain.
  - cmin (number)
    Has only an effect if `marker.color.line` is set to a numerical array. Sets the lower bound of the color domain.
  - autocolorscale (boolean)
    default: true
    Has only an effect if `marker.color.line` is set to a numerical array. Determines whether or not the colorscale is picked using the sign of values inside `marker.line.color`.
  - reversescale (boolean)
    Has only an effect if `marker.color.line` is set to a numerical array. Reverses the colorscale.
  - colorsrc (string)
    Sets the source reference on plot.ly for color .
  - widthsrc (string)
    Sets the source reference on plot.ly for width .
- colorbar (named list)
  - thicknessmode (enumerated: "fraction" | "pixels")
    default: "pixels"
    Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
  - thickness (number greater than or equal to 0)
    default: 30
    Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
  - lenmode (enumerated: "fraction" | "pixels")
    default: "fraction"
    Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
  - len (number greater than or equal to 0)
    default: 1
    Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
  - x (number)
    default: 1.02
    Sets the x position of the color bar (in plot fraction).
  - xanchor (enumerated: "left" | "center" | "right")
    default: "left"
    Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
  - xpad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the x direction.
  - y (number)
    default: 0.5
    Sets the y position of the color bar (in plot fraction).
  - yanchor (enumerated: "top" | "middle" | "bottom")
    default: "middle"
    Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
  - ypad (number greater than or equal to 0)
    default: 10
    Sets the amount of padding (in px) along the y direction.
  - outlinecolor (color)
    default: "#444"
    Sets the axis line color.
  - outlinewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - bordercolor (color)
    default: "#444"
    Sets the axis line color.
  - borderwidth (number greater than or equal to 0)
    default: 0
    Sets the width (in px) or the border enclosing this color bar.
  - bgcolor (color)
    default: "rgba(0,0,0,0)"
    Sets the color of padded area.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    default: ""
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - title (string)
    default: "Click to enter colorscale title"
    Sets the title of the color bar.
  - titlefont (named list)
    Sets this color bar's title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - titleside (enumerated: "right" | "top" | "bottom")
    default: "top"
    Determines the location of the colorbar title with respect to the color bar.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- symbolsrc (string)
  Sets the source reference on plot.ly for symbol .
- opacitysrc (string)
  Sets the source reference on plot.ly for opacity .
- sizesrc (string)
  Sets the source reference on plot.ly for size .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
textfont (named list)
Sets the text font.
- family (string)
- size (number greater than or equal to 1)
- color (color)
- familysrc (string)
  Sets the source reference on plot.ly for family .
- sizesrc (string)
  Sets the source reference on plot.ly for size .
- colorsrc (string)
  Sets the source reference on plot.ly for color .
textposition (enumerated: "top left" | "top center" | "top right" | "middle left" | "middle center" | "middle right" | "bottom left" | "bottom center" | "bottom right")
default: "middle center"
Sets the positions of the `text` elements with respects to the (x,y) coordinates.
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
geo (geoid)
default: geo
Sets a reference between this trace's geospatial coordinates and a geographic map. If "geo" (the default value), the geospatial coordinates refer to `layout.geo`. If "geo2", the geospatial coordinates refer to `layout.geo2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
lonsrc (string)
Sets the source reference on plot.ly for lon .
latsrc (string)
Sets the source reference on plot.ly for lat .
locationssrc (string)
Sets the source reference on plot.ly for locations .
textsrc (string)
Sets the source reference on plot.ly for text .
textpositionsrc (string)
Sets the source reference on plot.ly for textposition .

choropleth

A choropleth trace is initialized with plot_ly or add_trace:

plot_ly(df, type="choropleth"[, ...])

                      add_trace(p, type="choropleth"[, ...])

type ("choropleth")
locations (dataframe column, list, vector)
Sets the coordinates via location IDs or names. See `locationmode` for more info.
locationmode (enumerated: "ISO-3" | "USA-states" | "country names")
default: "ISO-3"
Determines the set of locations used to match entries in `locations` to regions on the map.
z (dataframe column, list, vector)
Sets the color values.
text (dataframe column, list, vector)
Sets the text elements associated with each location.
marker (named list)
- line (named list)
  - color (color)
    Sets the color of the lines bounding the marker points.
  - width (number greater than or equal to 0)
    Sets the width (in px) of the lines bounding the marker points.
  - colorsrc (string)
    Sets the source reference on plot.ly for color .
  - widthsrc (string)
    Sets the source reference on plot.ly for width .
zauto (boolean)
default: true
Determines the whether or not the color domain is computed with respect to the input data.
zmin (number)
Sets the lower bound of color domain.
zmax (number)
Sets the upper bound of color domain.
colorscale (colorscale)
Sets the colorscale.
autocolorscale (boolean)
default: true
Determines whether or not the colorscale is picked using the sign of the input z values.
reversescale (boolean)
Reverses the colorscale.
showscale (boolean)
default: true
Determines whether or not a colorbar is displayed for this trace.
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
colorbar (named list)
- thicknessmode (enumerated: "fraction" | "pixels")
  default: "pixels"
  Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot "fraction" or in "pixels. Use `thickness` to set the value.
- thickness (number greater than or equal to 0)
  default: 30
  Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- lenmode (enumerated: "fraction" | "pixels")
  default: "fraction"
  Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot "fraction" or in "pixels. Use `len` to set the value.
- len (number greater than or equal to 0)
  default: 1
  Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- x (number)
  default: 1.02
  Sets the x position of the color bar (in plot fraction).
- xanchor (enumerated: "left" | "center" | "right")
  default: "left"
  Sets this color bar's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the color bar.
- xpad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the x direction.
- y (number)
  default: 0.5
  Sets the y position of the color bar (in plot fraction).
- yanchor (enumerated: "top" | "middle" | "bottom")
  default: "middle"
  Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the color bar.
- ypad (number greater than or equal to 0)
  default: 10
  Sets the amount of padding (in px) along the y direction.
- outlinecolor (color)
  default: "#444"
  Sets the axis line color.
- outlinewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- bordercolor (color)
  default: "#444"
  Sets the axis line color.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) or the border enclosing this color bar.
- bgcolor (color)
  default: "rgba(0,0,0,0)"
  Sets the color of padded area.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  default: ""
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- title (string)
  default: "Click to enter colorscale title"
  Sets the title of the color bar.
- titlefont (named list)
  Sets this color bar's title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- titleside (enumerated: "right" | "top" | "bottom")
  default: "top"
  Determines the location of the colorbar title with respect to the color bar.
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
geo (geoid)
default: geo
Sets a reference between this trace's geospatial coordinates and a geographic map. If "geo" (the default value), the geospatial coordinates refer to `layout.geo`. If "geo2", the geospatial coordinates refer to `layout.geo2`, and so on.
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
locationssrc (string)
Sets the source reference on plot.ly for locations .
zsrc (string)
Sets the source reference on plot.ly for z .
textsrc (string)
Sets the source reference on plot.ly for text .

area

A area trace is initialized with plot_ly or add_trace:

plot_ly(df, type="area"[, ...])

                      add_trace(p, type="area"[, ...])

A area trace accepts any of the keys listed below.

type ("area")
r (dataframe column, list, vector)
For polar chart only.Sets the radial coordinates.
t (dataframe column, list, vector)
For polar chart only.Sets the angular coordinates.
marker (named list)
- color (color)
  Sets the marker color.
- size (number greater than or equal to 0)
  default: 6
  Sets the marker size (in px).
- symbol (enumerated: "0" | "circle" | "100" | "circle-open" | "200" | "circle-dot" | "300" | "circle-open-dot" | "1" | "square" | "101" | "square-open" | "201" | "square-dot" | "301" | "square-open-dot" | "2" | "diamond" | "102" | "diamond-open" | "202" | "diamond-dot" | "302" | "diamond-open-dot" | "3" | "cross" | "103" | "cross-open" | "203" | "cross-dot" | "303" | "cross-open-dot" | "4" | "x" | "104" | "x-open" | "204" | "x-dot" | "304" | "x-open-dot" | "5" | "triangle-up" | "105" | "triangle-up-open" | "205" | "triangle-up-dot" | "305" | "triangle-up-open-dot" | "6" | "triangle-down" | "106" | "triangle-down-open" | "206" | "triangle-down-dot" | "306" | "triangle-down-open-dot" | "7" | "triangle-left" | "107" | "triangle-left-open" | "207" | "triangle-left-dot" | "307" | "triangle-left-open-dot" | "8" | "triangle-right" | "108" | "triangle-right-open" | "208" | "triangle-right-dot" | "308" | "triangle-right-open-dot" | "9" | "triangle-ne" | "109" | "triangle-ne-open" | "209" | "triangle-ne-dot" | "309" | "triangle-ne-open-dot" | "10" | "triangle-se" | "110" | "triangle-se-open" | "210" | "triangle-se-dot" | "310" | "triangle-se-open-dot" | "11" | "triangle-sw" | "111" | "triangle-sw-open" | "211" | "triangle-sw-dot" | "311" | "triangle-sw-open-dot" | "12" | "triangle-nw" | "112" | "triangle-nw-open" | "212" | "triangle-nw-dot" | "312" | "triangle-nw-open-dot" | "13" | "pentagon" | "113" | "pentagon-open" | "213" | "pentagon-dot" | "313" | "pentagon-open-dot" | "14" | "hexagon" | "114" | "hexagon-open" | "214" | "hexagon-dot" | "314" | "hexagon-open-dot" | "15" | "hexagon2" | "115" | "hexagon2-open" | "215" | "hexagon2-dot" | "315" | "hexagon2-open-dot" | "16" | "octagon" | "116" | "octagon-open" | "216" | "octagon-dot" | "316" | "octagon-open-dot" | "17" | "star" | "117" | "star-open" | "217" | "star-dot" | "317" | "star-open-dot" | "18" | "hexagram" | "118" | "hexagram-open" | "218" | "hexagram-dot" | "318" | "hexagram-open-dot" | "19" | "star-triangle-up" | "119" | "star-triangle-up-open" | "219" | "star-triangle-up-dot" | "319" | "star-triangle-up-open-dot" | "20" | "star-triangle-down" | "120" | "star-triangle-down-open" | "220" | "star-triangle-down-dot" | "320" | "star-triangle-down-open-dot" | "21" | "star-square" | "121" | "star-square-open" | "221" | "star-square-dot" | "321" | "star-square-open-dot" | "22" | "star-diamond" | "122" | "star-diamond-open" | "222" | "star-diamond-dot" | "322" | "star-diamond-open-dot" | "23" | "diamond-tall" | "123" | "diamond-tall-open" | "223" | "diamond-tall-dot" | "323" | "diamond-tall-open-dot" | "24" | "diamond-wide" | "124" | "diamond-wide-open" | "224" | "diamond-wide-dot" | "324" | "diamond-wide-open-dot" | "25" | "hourglass" | "125" | "hourglass-open" | "26" | "bowtie" | "126" | "bowtie-open" | "27" | "circle-cross" | "127" | "circle-cross-open" | "28" | "circle-x" | "128" | "circle-x-open" | "29" | "square-cross" | "129" | "square-cross-open" | "30" | "square-x" | "130" | "square-x-open" | "31" | "diamond-cross" | "131" | "diamond-cross-open" | "32" | "diamond-x" | "132" | "diamond-x-open" | "33" | "cross-thin" | "133" | "cross-thin-open" | "34" | "x-thin" | "134" | "x-thin-open" | "35" | "asterisk" | "135" | "asterisk-open" | "36" | "hash" | "136" | "hash-open" | "236" | "hash-dot" | "336" | "hash-open-dot" | "37" | "y-up" | "137" | "y-up-open" | "38" | "y-down" | "138" | "y-down-open" | "39" | "y-left" | "139" | "y-left-open" | "40" | "y-right" | "140" | "y-right-open" | "41" | "line-ew" | "141" | "line-ew-open" | "42" | "line-ns" | "142" | "line-ns-open" | "43" | "line-ne" | "143" | "line-ne-open" | "44" | "line-nw" | "144" | "line-nw-open")
  default: "circle"
  Sets the marker symbol type. Adding 100 is equivalent to appending "-open" to a symbol name. Adding 200 is equivalent to appending "-dot" to a symbol name. Adding 300 is equivalent to appending "-open-dot" or "dot-open" to a symbol name.
- opacity (number between or equal to 0 and 1)
  Sets the marker opacity.
- colorsrc (string)
  Sets the source reference on plot.ly for color .
- sizesrc (string)
  Sets the source reference on plot.ly for size .
- symbolsrc (string)
  Sets the source reference on plot.ly for symbol .
- opacitysrc (string)
  Sets the source reference on plot.ly for opacity .
visible (enumerated: true | false | "legendonly")
default: true
Determines whether or not this trace is visible. If "legendonly", the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
showlegend (boolean)
default: true
Determines whether or not an item corresponding to this trace is shown in the legend.
legendgroup (string)
default: ""
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
opacity (number between or equal to 0 and 1)
default: 1
Sets the opacity of the trace.
name (string)
Sets the trace name. The trace name appear as the legend item and on hover.
uid (string)
default: ""
hoverinfo (flaglist)
flags: "x" | "y" | "z" | "text" | "name"
default: all
extras: "all" | "none"
examples: "x", "y", "x+y", "x+y+z", "all"
Determines which trace information appear on hover.
stream (named list)
- token (string)
  The stream id number links a data trace on a plot with a stream. See https://plot.ly/settings for more details.
- maxpoints (number greater than or equal to 0)
  Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to "50", only the newest 50 points will be displayed on the plot.
rsrc (string)
Sets the source reference on plot.ly for r .
tsrc (string)
Sets the source reference on plot.ly for t .

layout

font (named list)
Sets the global font. Note that fonts used in traces and other layout components inherit from the global font.
- family (string)
  default: ""Open sans", verdana, arial, sans-serif"
- size (number greater than or equal to 1)
  default: 12
- color (color)
  default: "#444"
title (string)
default: "Click to enter Plot title"
Sets the plot's title.
titlefont (named list)
Sets the title font.
- family (string)
- size (number greater than or equal to 1)
- color (color)
autosize (enumerated: true | false | "initial")
Determines whether or not the dimensions of the figure are computed as a function of the display size.
width (number greater than or equal to 10)
default: 700
Sets the plot's width (in px).
height (number greater than or equal to 10)
default: 450
Sets the plot's height (in px).
margin (named list)
- l (number greater than or equal to 0)
  default: 80
  Sets the left margin (in px).
- r (number greater than or equal to 0)
  default: 80
  Sets the right margin (in px).
- t (number greater than or equal to 0)
  default: 100
  Sets the top margin (in px).
- b (number greater than or equal to 0)
  default: 80
  Sets the bottom margin (in px).
- pad (number greater than or equal to 0)
  default: 0
  Sets the amount of padding (in px) between the plotting area and the axis lines
- autoexpand (boolean)
  default: true
paper_bgcolor (color)
default: "#fff"
Sets the color of paper where the graph is drawn.
plot_bgcolor (color)
default: "#fff"
Sets the color of plotting area in-between x and y axes.
separators (string)
default: ".,"
Sets the decimal and thousand separators. For example, ". " puts a '.' before decimals and a space between thousands.
hidesources (boolean)
Determines whether or not a text link citing the data source is placed at the bottom-right cored of the figure. Has only an effect only on graphs that have been generated via forked graphs from the plotly cloud.
smith (enumerated: false)
showlegend (boolean)
Determines whether or not a legend is drawn.
dragmode (enumerated: "zoom" | "pan" | "orbit" | "turntable")
Determines the mode of drag interactions.
hovermode (enumerated: "x" | "y" | "closest" | false)
Determines the mode of hover interactions.
xaxis (named list)
- title (string)
  Sets the title of this axis.
- titlefont (named list)
  Sets this axis' title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- type (enumerated: "-" | "linear" | "log" | "date" | "category")
  default: "-"
  Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
- autorange (enumerated: true | false | "reversed")
  default: true
  Determines whether or not the range of this axis is computed in relation to the input data. See `rangemode` for more info. If `range` is provided, then `autorange` is set to "false".
- rangemode (enumerated: "normal" | "tozero" | "nonnegative")
  default: "normal"
  If "normal", the range is computed in relation to the extrema of the input data. If "tozero"`, the range extends to 0, regardless of the input data If "nonnegative", the range is non-negative, regardless of the input data.
- range (list)
  Sets the range of this axis.
- fixedrange (boolean)
  Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- mirror (enumerated: true | "ticks" | false | "all" | "allticks")
  Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If "true", the axis lines are mirrored. If "ticks", the axis lines and ticks are mirrored. If "false", mirroring is disable. If "all", axis lines are mirrored on all shared-axes subplots. If "allticks", axis lines and ticks are mirrored on all shared-axes subplots.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- hoverformat (string)
  default: ""
  Sets the hover text formatting rule for data values on this axis, using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- showline (boolean)
  Determines whether or not a line bounding this axis is drawn.
- linecolor (color)
  default: "#444"
  Sets the axis line color.
- linewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- showgrid (boolean)
  Determines whether or not grid lines are drawn. If "true", the grid lines are drawn at every tick mark.
- gridcolor (color)
  default: "#eee"
  Sets the color of the grid lines.
- gridwidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the grid lines.
- zeroline (boolean)
  Determines whether or not a line is drawn at along the 0 value of this axis. If "true", the zero line is drawn on top of the grid lines.
- zerolinecolor (color)
  default: "#444"
  Sets the line color of the zero line.
- zerolinewidth (number)
  default: 1
  Sets the width (in px) of the zero line.
- anchor (enumerated: "free" | "/^x([2-9]|[1-9][0-9]+)?$/" | "/^y([2-9]|[1-9][0-9]+)?$/")
  If set to an opposite-letter axis id (e.g. `xaxis2`, `yaxis`), this axis is bound to the corresponding opposite-letter axis. If set to "free", this axis' position is determined by `position`.
- side (enumerated: "top" | "bottom" | "left" | "right")
  Determines whether a x (y) axis is positioned at the "bottom" ("left") or "top" ("right") of the plotting area.
- overlaying (enumerated: "free" | "/^x([2-9]|[1-9][0-9]+)?$/" | "/^y([2-9]|[1-9][0-9]+)?$/")
  If set a same-letter axis id, this axis is overlaid on top of the corresponding same-letter axis. If "false", this axis does not overlay any same-letter axes.
- domain (list)
  default: [0, 1]
  Sets the domain of this axis (in plot fraction).
- position (number between or equal to 0 and 1)
  default: 0
  Sets the position of this axis in the plotting space (in normalized coordinates). Only has an effect if `anchor` is set to "free".
- _deprecated
- _isSubplotObj
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
yaxis (named list)
- title (string)
  Sets the title of this axis.
- titlefont (named list)
  Sets this axis' title font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- type (enumerated: "-" | "linear" | "log" | "date" | "category")
  default: "-"
  Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
- autorange (enumerated: true | false | "reversed")
  default: true
  Determines whether or not the range of this axis is computed in relation to the input data. See `rangemode` for more info. If `range` is provided, then `autorange` is set to "false".
- rangemode (enumerated: "normal" | "tozero" | "nonnegative")
  default: "normal"
  If "normal", the range is computed in relation to the extrema of the input data. If "tozero"`, the range extends to 0, regardless of the input data If "nonnegative", the range is non-negative, regardless of the input data.
- range (list)
  Sets the range of this axis.
- fixedrange (boolean)
  Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
- tickmode (enumerated: "auto" | "linear" | "array")
  Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
- nticks (integer greater than or equal to 0)
  default: 0
  Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
- tick0 (number)
  default: 0
  Sets the placement of the first tick on this axis. Use with `dtick`.
- dtick (any)
  default: 1
  Sets the step in-between ticks on this axis
- tickvals (dataframe column, list, vector)
  Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticktext (dataframe column, list, vector)
  Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
- ticks (enumerated: "outside" | "inside" | "")
  Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
- mirror (enumerated: true | "ticks" | false | "all" | "allticks")
  Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If "true", the axis lines are mirrored. If "ticks", the axis lines and ticks are mirrored. If "false", mirroring is disable. If "all", axis lines are mirrored on all shared-axes subplots. If "allticks", axis lines and ticks are mirrored on all shared-axes subplots.
- ticklen (number greater than or equal to 0)
  default: 5
  Sets the tick length (in px).
- tickwidth (number greater than or equal to 0)
  default: 1
  Sets the tick width (in px).
- tickcolor (color)
  default: "#444"
  Sets the tick color.
- showticklabels (boolean)
  default: true
  Determines whether or not the tick labels are drawn.
- tickfont (named list)
  Sets the tick font.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- tickangle (angle)
  default: auto
  Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
- tickprefix (string)
  default: ""
  Sets a tick label prefix.
- showtickprefix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
- ticksuffix (string)
  default: ""
  Sets a tick label suffix.
- showticksuffix (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  Same as `showtickprefix` but for tick suffixes.
- showexponent (enumerated: "all" | "first" | "last" | "none")
  default: "all"
  If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
- exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
  default: "B"
  Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
- tickformat (string)
  default: ""
  Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- hoverformat (string)
  default: ""
  Sets the hover text formatting rule for data values on this axis, using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
- showline (boolean)
  Determines whether or not a line bounding this axis is drawn.
- linecolor (color)
  default: "#444"
  Sets the axis line color.
- linewidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the axis line.
- showgrid (boolean)
  Determines whether or not grid lines are drawn. If "true", the grid lines are drawn at every tick mark.
- gridcolor (color)
  default: "#eee"
  Sets the color of the grid lines.
- gridwidth (number greater than or equal to 0)
  default: 1
  Sets the width (in px) of the grid lines.
- zeroline (boolean)
  Determines whether or not a line is drawn at along the 0 value of this axis. If "true", the zero line is drawn on top of the grid lines.
- zerolinecolor (color)
  default: "#444"
  Sets the line color of the zero line.
- zerolinewidth (number)
  default: 1
  Sets the width (in px) of the zero line.
- anchor (enumerated: "free" | "/^x([2-9]|[1-9][0-9]+)?$/" | "/^y([2-9]|[1-9][0-9]+)?$/")
  If set to an opposite-letter axis id (e.g. `xaxis2`, `yaxis`), this axis is bound to the corresponding opposite-letter axis. If set to "free", this axis' position is determined by `position`.
- side (enumerated: "top" | "bottom" | "left" | "right")
  Determines whether a x (y) axis is positioned at the "bottom" ("left") or "top" ("right") of the plotting area.
- overlaying (enumerated: "free" | "/^x([2-9]|[1-9][0-9]+)?$/" | "/^y([2-9]|[1-9][0-9]+)?$/")
  If set a same-letter axis id, this axis is overlaid on top of the corresponding same-letter axis. If "false", this axis does not overlay any same-letter axes.
- domain (list)
  default: [0, 1]
  Sets the domain of this axis (in plot fraction).
- position (number between or equal to 0 and 1)
  default: 0
  Sets the position of this axis in the plotting space (in normalized coordinates). Only has an effect if `anchor` is set to "free".
- _deprecated
- _isSubplotObj
- tickvalssrc (string)
  Sets the source reference on plot.ly for tickvals .
- ticktextsrc (string)
  Sets the source reference on plot.ly for ticktext .
scene (named list)
- bgcolor (color)
  default: "rgba(0,0,0,0)"
- camera (named list)
  - up (named list)
    Sets the (x,y,z) components of the 'up' camera vector. This vector determines the up direction of this scene with respect to the page. The default is "{x: 0, y: 0, z: 1}" which means that the z axis points up.
    - x (number)
      default: 0
    - y (number)
      default: 0
    - z (number)
      default: 1
  - center (named list)
    Sets the (x,y,z) components of the 'center' camera vector This vector determines the translation (x,y,z) space about the center of this scene. By default, there is no such translation.
    - x (number)
      default: 0
    - y (number)
      default: 0
    - z (number)
      default: 0
  - eye (named list)
    Sets the (x,y,z) components of the 'eye' camera vector. This vector determines the view point about the origin of this scene.
    - x (number)
      default: 1.25
    - y (number)
      default: 1.25
    - z (number)
      default: 1.25
- domain (named list)
  - x (list)
    default: [0, 1]
    Sets the horizontal domain of this scene (in plot fraction).
  - y (list)
    default: [0, 1]
    Sets the vertical domain of this scene (in plot fraction).
- aspectmode (enumerated: "auto" | "cube" | "data" | "manual")
  default: "auto"
  If "cube", this scene's axes are drawn as a cube, regardless of the axes' ranges. If "data", this scene's axes are drawn in proportion with the axes' ranges. If "manual", this scene's axes are drawn in proportion with the input of "aspectratio" (the default behavior if "aspectratio" is provided). If "auto", this scene's axes are drawn using the results of "data" except when one axis is more than four times the size of the two others, where in that case the results of "cube" are used.
- aspectratio (named list)
  Sets this scene's axis aspectratio.
  - x (number greater than or equal to 0)
  - y (number greater than or equal to 0)
  - z (number greater than or equal to 0)
- xaxis (named list)
  - showspikes (boolean)
    default: true
    Sets whether or not spikes starting from data points to this axis' wall are shown on hover.
  - spikesides (boolean)
    default: true
    Sets whether or not spikes extending from the projection data points to this axis' wall boundaries are shown on hover.
  - spikethickness (number greater than or equal to 0)
    default: 2
    Sets the thickness (in px) of the spikes.
  - spikecolor (color)
    default: "rgb(0,0,0)"
    Sets the color of the spikes.
  - showbackground (boolean)
    Sets whether or not this axis' wall has a background color.
  - backgroundcolor (color)
    default: "rgba(204, 204, 204, 0.5)"
    Sets the background color of this axis' wall.
  - showaxeslabels (boolean)
    default: true
    Sets whether or not this axis is labeled
  - title (string)
    Sets the title of this axis.
  - titlefont (named list)
    Sets this axis' title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - type (enumerated: "-" | "linear" | "log" | "date" | "category")
    default: "-"
    Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
  - autorange (enumerated: true | false | "reversed")
    default: true
    Determines whether or not the range of this axis is computed in relation to the input data. See `rangemode` for more info. If `range` is provided, then `autorange` is set to "false".
  - rangemode (enumerated: "normal" | "tozero" | "nonnegative")
    default: "normal"
    If "normal", the range is computed in relation to the extrema of the input data. If "tozero"`, the range extends to 0, regardless of the input data If "nonnegative", the range is non-negative, regardless of the input data.
  - range (list)
    Sets the range of this axis.
  - fixedrange (boolean)
    Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - mirror (enumerated: true | "ticks" | false | "all" | "allticks")
    Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If "true", the axis lines are mirrored. If "ticks", the axis lines and ticks are mirrored. If "false", mirroring is disable. If "all", axis lines are mirrored on all shared-axes subplots. If "allticks", axis lines and ticks are mirrored on all shared-axes subplots.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - hoverformat (string)
    default: ""
    Sets the hover text formatting rule for data values on this axis, using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - showline (boolean)
    Determines whether or not a line bounding this axis is drawn.
  - linecolor (color)
    default: "#444"
    Sets the axis line color.
  - linewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - showgrid (boolean)
    Determines whether or not grid lines are drawn. If "true", the grid lines are drawn at every tick mark.
  - gridcolor (color)
    default: "rgb(204, 204, 204)"
    Sets the color of the grid lines.
  - gridwidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the grid lines.
  - zeroline (boolean)
    Determines whether or not a line is drawn at along the 0 value of this axis. If "true", the zero line is drawn on top of the grid lines.
  - zerolinecolor (color)
    default: "#444"
    Sets the line color of the zero line.
  - zerolinewidth (number)
    default: 1
    Sets the width (in px) of the zero line.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- yaxis (named list)
  - showspikes (boolean)
    default: true
    Sets whether or not spikes starting from data points to this axis' wall are shown on hover.
  - spikesides (boolean)
    default: true
    Sets whether or not spikes extending from the projection data points to this axis' wall boundaries are shown on hover.
  - spikethickness (number greater than or equal to 0)
    default: 2
    Sets the thickness (in px) of the spikes.
  - spikecolor (color)
    default: "rgb(0,0,0)"
    Sets the color of the spikes.
  - showbackground (boolean)
    Sets whether or not this axis' wall has a background color.
  - backgroundcolor (color)
    default: "rgba(204, 204, 204, 0.5)"
    Sets the background color of this axis' wall.
  - showaxeslabels (boolean)
    default: true
    Sets whether or not this axis is labeled
  - title (string)
    Sets the title of this axis.
  - titlefont (named list)
    Sets this axis' title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - type (enumerated: "-" | "linear" | "log" | "date" | "category")
    default: "-"
    Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
  - autorange (enumerated: true | false | "reversed")
    default: true
    Determines whether or not the range of this axis is computed in relation to the input data. See `rangemode` for more info. If `range` is provided, then `autorange` is set to "false".
  - rangemode (enumerated: "normal" | "tozero" | "nonnegative")
    default: "normal"
    If "normal", the range is computed in relation to the extrema of the input data. If "tozero"`, the range extends to 0, regardless of the input data If "nonnegative", the range is non-negative, regardless of the input data.
  - range (list)
    Sets the range of this axis.
  - fixedrange (boolean)
    Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - mirror (enumerated: true | "ticks" | false | "all" | "allticks")
    Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If "true", the axis lines are mirrored. If "ticks", the axis lines and ticks are mirrored. If "false", mirroring is disable. If "all", axis lines are mirrored on all shared-axes subplots. If "allticks", axis lines and ticks are mirrored on all shared-axes subplots.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - hoverformat (string)
    default: ""
    Sets the hover text formatting rule for data values on this axis, using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - showline (boolean)
    Determines whether or not a line bounding this axis is drawn.
  - linecolor (color)
    default: "#444"
    Sets the axis line color.
  - linewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - showgrid (boolean)
    Determines whether or not grid lines are drawn. If "true", the grid lines are drawn at every tick mark.
  - gridcolor (color)
    default: "rgb(204, 204, 204)"
    Sets the color of the grid lines.
  - gridwidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the grid lines.
  - zeroline (boolean)
    Determines whether or not a line is drawn at along the 0 value of this axis. If "true", the zero line is drawn on top of the grid lines.
  - zerolinecolor (color)
    default: "#444"
    Sets the line color of the zero line.
  - zerolinewidth (number)
    default: 1
    Sets the width (in px) of the zero line.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- zaxis (named list)
  - showspikes (boolean)
    default: true
    Sets whether or not spikes starting from data points to this axis' wall are shown on hover.
  - spikesides (boolean)
    default: true
    Sets whether or not spikes extending from the projection data points to this axis' wall boundaries are shown on hover.
  - spikethickness (number greater than or equal to 0)
    default: 2
    Sets the thickness (in px) of the spikes.
  - spikecolor (color)
    default: "rgb(0,0,0)"
    Sets the color of the spikes.
  - showbackground (boolean)
    Sets whether or not this axis' wall has a background color.
  - backgroundcolor (color)
    default: "rgba(204, 204, 204, 0.5)"
    Sets the background color of this axis' wall.
  - showaxeslabels (boolean)
    default: true
    Sets whether or not this axis is labeled
  - title (string)
    Sets the title of this axis.
  - titlefont (named list)
    Sets this axis' title font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - type (enumerated: "-" | "linear" | "log" | "date" | "category")
    default: "-"
    Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
  - autorange (enumerated: true | false | "reversed")
    default: true
    Determines whether or not the range of this axis is computed in relation to the input data. See `rangemode` for more info. If `range` is provided, then `autorange` is set to "false".
  - rangemode (enumerated: "normal" | "tozero" | "nonnegative")
    default: "normal"
    If "normal", the range is computed in relation to the extrema of the input data. If "tozero"`, the range extends to 0, regardless of the input data If "nonnegative", the range is non-negative, regardless of the input data.
  - range (list)
    Sets the range of this axis.
  - fixedrange (boolean)
    Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
  - tickmode (enumerated: "auto" | "linear" | "array")
    Sets the tick mode for this axis. If "auto", the number of ticks is set via `nticks`. If "linear", the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` ("linear" is the default value if `tick0` and `dtick` are provided). If "array", the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. ("array" is the default value if `tickvals` is provided).
  - nticks (integer greater than or equal to 0)
    default: 0
    Sets the number of ticks. Has an effect only if `tickmode` is set to "auto".
  - tick0 (number)
    default: 0
    Sets the placement of the first tick on this axis. Use with `dtick`.
  - dtick (any)
    default: 1
    Sets the step in-between ticks on this axis
  - tickvals (dataframe column, list, vector)
    Sets the values at which ticks on this axis appear. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticktext (dataframe column, list, vector)
    Sets the text displayed at the ticks position via `tickvals`. Only has an effect if `tickmode` is set to "array". Used with `ticktext`.
  - ticks (enumerated: "outside" | "inside" | "")
    Determines whether ticks are drawn or not. If "", this axis' ticks are not drawn. If "outside" ("inside"), this axis' are drawn outside (inside) the axis lines.
  - mirror (enumerated: true | "ticks" | false | "all" | "allticks")
    Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If "true", the axis lines are mirrored. If "ticks", the axis lines and ticks are mirrored. If "false", mirroring is disable. If "all", axis lines are mirrored on all shared-axes subplots. If "allticks", axis lines and ticks are mirrored on all shared-axes subplots.
  - ticklen (number greater than or equal to 0)
    default: 5
    Sets the tick length (in px).
  - tickwidth (number greater than or equal to 0)
    default: 1
    Sets the tick width (in px).
  - tickcolor (color)
    default: "#444"
    Sets the tick color.
  - showticklabels (boolean)
    default: true
    Determines whether or not the tick labels are drawn.
  - tickfont (named list)
    Sets the tick font.
    - family (string)
    - size (number greater than or equal to 1)
    - color (color)
  - tickangle (angle)
    default: auto
    Sets the angle of the tick labels with respect to the horizontal. For example, a `tickangle` of -90 draws the tick labels vertically.
  - tickprefix (string)
    default: ""
    Sets a tick label prefix.
  - showtickprefix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all tick labels are displayed with a prefix. If "first", only the first tick is displayed with a prefix. If "last", only the last tick is displayed with a suffix. If "none", tick prefixes are hidden.
  - ticksuffix (string)
    default: ""
    Sets a tick label suffix.
  - showticksuffix (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    Same as `showtickprefix` but for tick suffixes.
  - showexponent (enumerated: "all" | "first" | "last" | "none")
    default: "all"
    If "all", all exponents are shown besides their significands. If "first", only the exponent of the first tick is shown. If "last", only the exponent of the last tick is shown. If "none", no exponents appear.
  - exponentformat (enumerated: "none" | "e" | "E" | "power" | "SI" | "B")
    default: "B"
    Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If "none", it appears as 1,000,000,000. If "e", 1e+9. If "E", 1E+9. If "power", 1x10^9 (with 9 in a super script). If "SI", 1G. If "B", 1B.
  - tickformat (string)
    default: ""
    Sets the tick label formatting rule using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - hoverformat (string)
    default: ""
    Sets the hover text formatting rule for data values on this axis, using the python/d3 number formatting language. See https://github.com/mbostock/d3/wiki/Formatting#numbers or https://docs.python.org/release/3.1.3/library/string.html#formatspec for more info.
  - showline (boolean)
    Determines whether or not a line bounding this axis is drawn.
  - linecolor (color)
    default: "#444"
    Sets the axis line color.
  - linewidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the axis line.
  - showgrid (boolean)
    Determines whether or not grid lines are drawn. If "true", the grid lines are drawn at every tick mark.
  - gridcolor (color)
    default: "rgb(204, 204, 204)"
    Sets the color of the grid lines.
  - gridwidth (number greater than or equal to 0)
    default: 1
    Sets the width (in px) of the grid lines.
  - zeroline (boolean)
    Determines whether or not a line is drawn at along the 0 value of this axis. If "true", the zero line is drawn on top of the grid lines.
  - zerolinecolor (color)
    default: "#444"
    Sets the line color of the zero line.
  - zerolinewidth (number)
    default: 1
    Sets the width (in px) of the zero line.
  - tickvalssrc (string)
    Sets the source reference on plot.ly for tickvals .
  - ticktextsrc (string)
    Sets the source reference on plot.ly for ticktext .
- _deprecated
- _isSubplotObj
geo (named list)
- domain (named list)
  - x (list)
    default: [0, 1]
    Sets the horizontal domain of this map (in plot fraction).
  - y (list)
    default: [0, 1]
    Sets the vertical domain of this map (in plot fraction).
- resolution (enumerated: "110" | "50")
  default: "110"
  Sets the resolution of the base layers. The values have units of km/mm e.g. 110 corresponds to a scale ratio of 1:110,000,000.
- scope (enumerated: "world" | "usa" | "europe" | "asia" | "africa" | "north america" | "south america")
  default: "world"
  Set the scope of the map.
- projection (named list)
  - type (enumerated: "equirectangular" | "mercator" | "orthographic" | "natural earth" | "kavrayskiy7" | "miller" | "robinson" | "eckert4" | "azimuthal equal area" | "azimuthal equidistant" | "conic equal area" | "conic conformal" | "conic equidistant" | "gnomonic" | "stereographic" | "mollweide" | "hammer" | "transverse mercator" | "albers usa")
    Sets the projection type.
  - rotation (named list)
    - lon (number)
      Rotates the map along parallels (in degrees East).
    - lat (number)
      Rotates the map along meridians (in degrees North).
    - roll (number)
      Roll the map (in degrees) For example, a roll of "180" makes the map appear upside down.
  - parallels (list)
    For conic projection types only. Sets the parallels (tangent, secant) where the cone intersects the sphere.
  - scale (number between or equal to 0 and 10)
    default: 1
    Zooms in or out on the map view.
- showcoastlines (boolean)
  Sets whether or not the coastlines are drawn.
- coastlinecolor (color)
  default: "#444"
  Sets the coastline color.
- coastlinewidth (number greater than or equal to 0)
  default: 1
  Sets the coastline stroke width (in px).
- showland (boolean)
  Sets whether or not land masses are filled in color.
- landcolor (color)
  default: "#F0DC82"
  Sets the land mass color.
- showocean (boolean)
  Sets whether or not oceans are filled in color.
- oceancolor (color)
  default: "#3399FF"
  Sets the ocean color
- showlakes (boolean)
  Sets whether or not lakes are drawn.
- lakecolor (color)
  default: "#3399FF"
  Sets the color of the lakes.
- showrivers (boolean)
  Sets whether or not rivers are drawn.
- rivercolor (color)
  default: "#3399FF"
  Sets color of the rivers.
- riverwidth (number greater than or equal to 0)
  default: 1
  Sets the stroke width (in px) of the rivers.
- showcountries (boolean)
  Sets whether or not country boundaries are drawn.
- countrycolor (color)
  default: "#444"
  Sets line color of the country boundaries.
- countrywidth (number greater than or equal to 0)
  default: 1
  Sets line width (in px) of the country boundaries.
- showsubunits (boolean)
  Sets whether or not boundaries of subunits within countries (e.g. states, provinces) are drawn.
- subunitcolor (color)
  default: "#444"
  Sets the color of the subunits boundaries.
- subunitwidth (number greater than or equal to 0)
  default: 1
  Sets the stroke width (in px) of the subunits boundaries.
- showframe (boolean)
  Sets whether or not a frame is drawn around the map.
- framecolor (color)
  default: "#444"
  Sets the color the frame.
- framewidth (number greater than or equal to 0)
  default: 1
  Sets the stroke width (in px) of the frame.
- bgcolor (color)
  default: "#fff"
  Set the background color of the map
- lonaxis (named list)
  - range (list)
    Sets the range of this axis (in degrees).
  - showgrid (boolean)
    Sets whether or not graticule are shown on the map.
  - tick0 (number)
    Sets the graticule's starting tick longitude/latitude.
  - dtick (number)
    Sets the graticule's longitude/latitude tick step.
  - gridcolor (color)
    default: "#eee"
    Sets the graticule's stroke color.
  - gridwidth (number greater than or equal to 0)
    default: 1
    Sets the graticule's stroke width (in px).
- lataxis (named list)
  - range (list)
    Sets the range of this axis (in degrees).
  - showgrid (boolean)
    Sets whether or not graticule are shown on the map.
  - tick0 (number)
    Sets the graticule's starting tick longitude/latitude.
  - dtick (number)
    Sets the graticule's longitude/latitude tick step.
  - gridcolor (color)
    default: "#eee"
    Sets the graticule's stroke color.
  - gridwidth (number greater than or equal to 0)
    default: 1
    Sets the graticule's stroke width (in px).
- _isSubplotObj
legend (named list)
- bgcolor (color)
  Sets the legend background color.
- bordercolor (color)
  default: "#444"
  Sets the color of the border enclosing the legend.
- borderwidth (number greater than or equal to 0)
  default: 0
  Sets the width (in px) of the border enclosing the legend.
- font (named list)
  Sets the font used to text the legend items.
  - family (string)
  - size (number greater than or equal to 1)
  - color (color)
- traceorder (flaglist)
  flags: "reversed" | "grouped"
  extras: "normal"
  examples: "reversed", "grouped", "reversed+grouped", "normal"
  Determines the order at which the legend items are displayed. If "normal", the items are displayed top-to-bottom in the same order as the input data. If "reversed", the items are displayed in the opposite order as "normal". If "grouped", the items are displayed in groups (when a trace `legendgroup` is provided). if "grouped+reversed", the items are displayed in the opposite order as "grouped".
- tracegroupgap (number greater than or equal to 0)
  default: 10
  Sets the amount of vertical space (in px) between legend groups.
- x (number between or equal to -2 and 3)
  default: 1.02
  Sets the x position (in normalized coordinates) of the legend.
- xanchor (enumerated: "auto" | "left" | "center" | "right")
  default: "left"
  Sets the legend's horizontal position anchor This anchor binds the `x` position to the "left", "center" or "right" of the legend.
- y (number between or equal to -2 and 3)
  default: 1
  Sets the y position (in normalized coordinates) of the legend.
- yanchor (enumerated: "auto" | "top" | "middle" | "bottom")
  default: "auto"
  Sets the legend's vertical position anchor This anchor binds the `y` position to the "top", "middle" or "bottom" of the legend.
annotations (named list)
- items
shapes (named list)
- items
radialaxis (named list)
- range (list)
  Defines the start and end point of this radial axis.
- domain (list)
  default: [0, 1]
  Polar chart subplots are not supported yet. This key has currently no effect.
- orientation (number)
  Sets the orientation (an angle with respect to the origin) of the radial axis.
- showline (boolean)
  Determines whether or not the line bounding this radial axis will be shown on the figure.
- showticklabels (boolean)
  Determines whether or not the radial axis ticks will feature tick labels.
- tickorientation (enumerated: "horizontal" | "vertical")
  Sets the orientation (from the paper perspective) of the radial axis tick labels.
- ticklen (number greater than or equal to 0)
  Sets the length of the tick lines on this radial axis.
- tickcolor (color)
  Sets the color of the tick lines on this radial axis.
- ticksuffix (string)
  Sets the length of the tick lines on this radial axis.
- endpadding (number)
- visible (boolean)
  Determines whether or not this axis will be visible.
angularaxis (named list)
- range (list)
  Defines the start and end point of this angular axis.
- domain (list)
  default: [0, 1]
  Polar chart subplots are not supported yet. This key has currently no effect.
- showline (boolean)
  Determines whether or not the line bounding this angular axis will be shown on the figure.
- showticklabels (boolean)
  Determines whether or not the angular axis ticks will feature tick labels.
- tickorientation (enumerated: "horizontal" | "vertical")
  Sets the orientation (from the paper perspective) of the angular axis tick labels.
- ticklen (number greater than or equal to 0)
  Sets the length of the tick lines on this angular axis.
- tickcolor (color)
  Sets the color of the tick lines on this angular axis.
- ticksuffix (string)
  Sets the length of the tick lines on this angular axis.
- endpadding (number)
- visible (boolean)
  Determines whether or not this axis will be visible.
direction (enumerated: "clockwise" | "counterclockwise")
For polar plots only. Sets the direction corresponding to positive angles.
orientation (angle)
For polar plots only. Rotates the entire polar by the given angle.